Pular para o conteúdo principal
POST
/
agents

​
Endpoint

POST https://gateway.orkeia.ai/agents

​
Cabeçalhos

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

​
Corpo da Requisição (JSON)

Todos os campos abaixo são obrigatórios
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
Clique aqui para saber mais o que são Ferramentas, Bases de Conhecimento e Modelos de IA!
{
  "name": "Nome do agente",
  "enabled": "true",
  "model": "sabia-3",
  "auto": "false",
 "reasoning": "false",
  "publisher": "ork-123",
  "temperature": "1",
  "role": "criador de conteúdo",
  "objective": "tem como objetivo fazer tal tarefa",
  "referencies": "texto de referencia",
  "can_delegate": "false",
  "can_code": "false",
  "multimodal": "false",
  "sectors": ["market"],
  "tools": ["web_scrapper"],
  "knowledgeBases": ["market_base"]
}

​
Exemplo (cURL)

curl -X POST "https://gateway.orkeia.ai/agents" \
  -H "authorization:  <seu_token>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Nome do agente", "enabled": true
   "enabled": "true",
  "model": "sabia-3",
  "auto": "false",
 "reasoning": "false",
  "publisher": "ork-123",
  "temperature": "0.3",
  "role": "criador de conteúdo",
  "objective": "tem como objetivo fazer tal tarefa",
  "referencies": "texto de referencia",
  "can_delegate": "false",
  "can_code": "false",
  "multimodal": "false",
  "sectors": ["market"],
  "tools": ["web_scrapper"],
  "knowledgeBases": ["market_base"]
  }'

​
Respostas

​
Response - Success

response
{
  "status": "OK",
  "data": { "id": "string_id"}
}

​
500 — Bad Request

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

​
400 — Client Error

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