Saltar al contenido principal
PUT
/
agents
/
{id}

​
Endpoint

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

​
Cabeçalhos

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

​
Parámetros de camino

{
  "id": "ID del agente (obligatorio)"
}

​
Cuerpo de la solicitud

Todos los campos de Agentes, salvo el id, son mutables.
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 de controlar la aleatoriedad de las respuestas del modelo. Valores más cercanos a 0 tienden a ser más determinísticos, mientras que 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
{
  "name": "Nuevo nombre del agente",
  "enabled": true
}

​
Ejemplo (cURL)

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

​
Respuestas

​
Response - Éxito

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

​
500 — Solicitud Incorrecta

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

​
400 — Error del Cliente

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