Saltar al contenido principal
PUT
Actualizar agente

Autorizaciones

Authorization
string
header
requerido

Token JWT de autenticación

Encabezados

x-company-id
string

Identificador de la empresa objetivo. Obligatorio solo para API keys globales (type=global). Se ignora para API keys de empresa y usuarios humanos.

Parámetros de ruta

id
string
requerido

ID del agente

Cuerpo

application/json
name
string

Nombre del agente en la plataforma.

welcome_message
object | null

Mensaje de bienvenida. null lo elimina.

prompts
object

Prompts del agente. Solo cambian los campos enviados; las listas enviadas reemplazan las actuales.

agent_flow
string

ID del flujo de ejecución del agente.

Minimum string length: 1
status
enum<string>

Estado del agente.

Opciones disponibles:
ACTIVE,
DRAFT,
INACTIVE,
DELETED
general_config
object

Configuración general del agente

model_config
object
specialist_config
object

Configuración del specialist (calificación e ICP)

avatar_color
string

Color del avatar del agente.

avatar_initials
string

Iniciales que se muestran en el avatar (hasta 2 caracteres).

Maximum string length: 2
personality_presets
enum<string>[]

Perfiles de personalidad predefinidos (hasta 3).

Maximum array length: 3
Opciones disponibles:
FRIENDLY,
DIDACTIC,
CURIOUS,
FORMAL,
PLAYFUL,
PERSUASIVE
knowledge_base
string[]

IDs de los conocimientos que consulta el agente.

Respuesta

200 - application/json
_id
object
requerido
name
string
requerido
agent_flow
object
requerido
prompts
object
requerido
company
object
requerido
model_config
object
requerido
status
enum<string>
requerido
Opciones disponibles:
ACTIVE,
DRAFT,
INACTIVE,
DELETED
general_config
object
specialist_config
object
knowledge_base
object[]
avatar_color
string
avatar_initials
string
personality_presets
enum<string>[]
Opciones disponibles:
FRIENDLY,
DIDACTIC,
CURIOUS,
FORMAL,
PLAYFUL,
PERSUASIVE
steps
object[]