Skip to main content
PUT
Editar agente
Actualiza uno o más campos de un agente personalizado. Los campos que no envíes conservan su valor actual. Antes de empezar, necesitas:
  • Una API key.
  • El agentId, disponible en la URL del agente dentro de la plataforma.

Actualizar el agente

Llama a PUT /agents/{agentId} con los campos que quieres cambiar. Sustituye {agentId} y TU_API_KEY:
Si incluyes modelConfig, toolIds o topicIds, ese valor reemplaza por completo al anterior. Un arreglo vacío en toolIds o topicIds quita la lista.

Campos

modelConfig

provider y model son obligatorios cuando envías este objeto. temperature es opcional.

Respuesta

Un 200 devuelve el agente actualizado.

Errores frecuentes

Authorizations

x-ib-api-key
string
header
required

Path Parameters

agentId
string
required

Identificador del agente. Solicítalo con tu ejecutivo de cuenta.

Body

application/json

Campos a modificar. Todos son opcionales. Los que omites conservan su valor actual.

name
string

Nombre del agente. Si lo envías, no puede ir vacío.

Minimum string length: 1
description
string

Descripción del agente.

instructions
string

Instrucciones que definen el comportamiento del agente.

modelConfig
object
toolIds
string[]

Identificadores de las herramientas del agente. Si lo envías, reemplaza la lista completa. Un arreglo vacío las quita.

topicIds
string[]

Identificadores de los temas del agente. Si lo envías, reemplaza la lista completa. Un arreglo vacío los quita.

isActive
boolean

Indica si el agente acepta ejecuciones. Con false, ejecutar el agente responde 400.

version
integer

Versión del agente. Entero positivo.

Required range: x >= 1

Response

Agente actualizado.

id
string
required

Identificador del agente.

tenantId
string
required

Identificador de tu cuenta.

name
string
required

Nombre del agente.

Minimum string length: 1
version
integer
required

Versión del agente.

Required range: x >= 1
createdAt
number
required

Marca de tiempo de creación en milisegundos (epoch).

lastUpdatedAt
number
required

Marca de tiempo de la última actualización en milisegundos (epoch).

description
string

Descripción del agente.

instructions
string

Instrucciones del agente.

modelConfig
object
toolIds
string[]

Identificadores de las herramientas asociadas.

topicIds
string[]

Identificadores de los temas asociados.

isActive
boolean

Indica si el agente acepta ejecuciones.