Pular para o conteúdo principal
PUT
/
agents
/
{id}

​
Endpoint

PUT https://gateway.orkeia.ai/agents/{id}

​
Cabeçalhos

authorization:  <seu_token>
Content-Type: application/json

​
Parâmetros de caminho

{
  "id": "ID do agente (obrigatório)"
}

​
Request body

Todos os campos de Agentes, salvo o id, são mutaveis.
CampoTipoDescrição
namestringNome do agente
enabledbooleanSe o agente está ativo
modelstring / Modelid do modelo ou modelo de IA
autobooleanSe o agente está ativo
reasoningbooleanSe o agente tem permissao para processar o pensamento
publisherstringId de quem criou o agente
temperaturenumber (0.0 até 1.0)Responsável por controlar a randomicidade das respostas do modelo. Valores mais proximos de 0 tendem a ser mais determinísticos, enquanto mais proximos de 1 tendem a ser mais variáveis.
rolestringPapel que o agente irá desempenhar
objectivestringObjetivo do agente em cada interação
referenciesstringReferência textual que o agente ira utilizar
can_delegatebooleanO agente pode delegar tarefas?
can_codebooleanO agente pode programar?
multimodalbooleanO agente tem capacidade de interagir com multiplos modos (imagem, texto, audio)?
sectorsarray(String)array de setores que usarão o agente
toolsarray(String) / array(Tools)array de ferramentas que o agente pode usar
knowledgeBasesarray(String) / array(KnowledgeBase)array de bases de conhecimento que poderão ser usadas pelo agente
{
  "name": "Novo nome do agente",
  "enabled": true
}

​
Exemplo (cURL)

curl -X PUT "https://gateway.orkeia.ai/agents/agent123" \
  -H "authorization:  <seu_token>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Novo nome do agente", "enabled": true}'

​
Respostas

​
Response - Success

{
"status": "OK",
   "data": { "true" }
}

​
500 — Bad Request

{
  "status": "ERROR",
  "code": "server/error",
  "data": null
}

​
400 — Client Error

{
  "status": "ERROR",
  "code": "client/error",
  "data": null
}