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 toolIds, ese valor reemplaza por completo al anterior. Un arreglo vacío quita la lista.

Campos

Instrucciones por canal

En instructions puedes adaptar indicaciones con bloques condicionales. Usa uno de estos valores exactos:
WhatsApp siempre usa chat-conversation. No existe un modo whatsapp.
La sintaxis es:
Por ejemplo, puedes actualizar las instrucciones con una guía distinta para voz y texto:
  • Coloca cada bloque junto al paso que modifica, no en una sección separada de reglas por modo.
  • Dentro del bloque, indica directamente cómo responder; no le pidas al agente detectar el canal ni revisar los bloques.
  • Para voz, prioriza respuestas breves, naturales y orales, sin listas largas ni formato visual.
  • Para texto, describe en lenguaje natural si quieres párrafos, listas o mensajes separados.
  • No uses {{variable}} para elegir el canal; esa sintaxis corresponde a argumentos de herramientas.

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.

toolIds
string[]

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

isActive
boolean

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

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.