Saltar al contenido principal
POST
/
agents

​
Endpoint

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

​
Encabezados

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

​
Cuerpo de la Solicitud (JSON)

Todos los campos a continuación son obligatorios
CampoTipoDescripción
namestringNombre del agente
enabledbooleanSi el agente está activo
modelstring / Modelid del modelo o modelo de IA
autobooleanSi el agente está activo
reasoningbooleanSi el agente tiene permiso para procesar el pensamiento
publisherstringId de quien creó el agente
temperaturenumber (0.0 hasta 1.0)Responsable por controlar la aleatoriedad de las respuestas del modelo. Valores más cercanos a 0 tienden a ser más determinísticos, mientras más cercanos a 1 tienden a ser más variables.
rolestringPapel que el agente desempeñará
objectivestringObjetivo del agente en cada interacción
referenciasstringReferencia textual que el agente utilizará
can.delegateboolean¿Puede el agente delegar tareas?
can_codeboolean¿Puede el agente programar?
multimodalboolean¿Puede el agente interactuar con múltiples modos (imagen, texto, audio)?
sectorsarray(String)array de sectores que usarán el agente
toolsarray(String) / array(Tools)array de herramientas que el agente puede usar
knowledgeBasesarray(String) / array(KnowledgeBase)array de bases de conocimiento que podrán ser usadas por el agente
¡Haz clic aquí para saber más sobre Herramientas, Bases de Conocimiento y Modelos de IA!
{
  "name": "Nombre del agente",
  "enabled": "true",
  "model": "sabia-3",
  "auto": "false",
 "reasoning": "false",
  "publisher": "ork-123",
  "temperature": "1",
  "role": "creador de contenido",
  "objective": "tiene como objetivo realizar tal tarea",
  "referencias": "texto de referencia",
  "can.delegate": "false",
  "can_code": "false",
  "multimodal": "false",
  "sectors": ["market"],
  "tools": ["web_scrapper"],
  "knowledgeBases": ["market_base"]
}

​
Ejemplo (cURL)

curl -X POST "https://gateway.orkeia.ai/agents" \
  -H "authorization:  <tu_token>" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Nombre del agente", "enabled": true
   "enabled": "true",
  "model": "sabia-3",
  "auto": "false",
 "reasoning": "false",
  "publisher": "ork-123",
  "temperature": "0.3",
  "role": "creador de contenido",
  "objective": "tiene como objetivo realizar tal tarea",
  "referencias": "texto de referencia",
  "can.delegate": "false",
  "can_code": "false",
  "multimodal": "false",
  "sectors": ["market"],
  "tools": ["web_scrapper"],
  "knowledgeBases": ["market_base"]
  }'

​
Respuestas

​
Response - Success

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

​
500 — Error Interno del Servidor

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

​
400 — Error del Cliente

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