Saltar para o conteúdo principal
PATCH
/
public
/
api
/
v1
/
agents
/
{agentPublicId}
/
model
Update the agent's model selection
curl --request PATCH \
  --url https://api.gennia.ai/public/api/v1/agents/{agentPublicId}/model \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "aiModelPublicId": "9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21",
  "temperature": 0.7,
  "thinkingEffort": "medium",
  "thinkingEnabled": true
}
'
{
  "aiModelName": "<string>",
  "aiModelPublicId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "capabilities": {
    "contextWindow": 123,
    "maxTemperature": 123,
    "minTemperature": 123,
    "supportsDocument": true,
    "supportsImage": true,
    "supportsTemperature": true,
    "supportsThinking": true
  },
  "modelId": "<string>",
  "provider": "<string>",
  "temperature": 123,
  "thinkingEffort": "<string>",
  "thinkingEnabled": true
}

Autorizações

X-Api-Key
string
header
obrigatório

Parâmetros de caminho

agentPublicId
string<uuid>
obrigatório

Corpo

application/json

Body for updating the agent's AI model and decoding settings. Fields are tri-state: omit to leave unchanged, set to a value to update, or send null to clear.

aiModelPublicId
object

Public ID of the AI model to use.

Exemplo:

"9c3a4d22-1a8d-4b3f-9b1e-7a0f0c4f3e21"

temperature
object

Sampling temperature between 0.0 and 2.0.

Exemplo:

0.7

thinkingEffort
object

Reasoning effort level when thinking is enabled.

Exemplo:

"medium"

thinkingEnabled
object

Enable extended thinking for reasoning-capable models.

Exemplo:

true

Resposta

OK

Agent model selection + read-only capability block.

aiModelName
string
aiModelPublicId
string<uuid>
capabilities
object
modelId
string
provider
string
temperature
number<float>
thinkingEffort
string
thinkingEnabled
boolean