Actualizar un agente

Actualiza parcialmente la configuración de un agente del negocio autenticado.

PATCH/api/external/v2/agents/:agent_id

Autenticación

Este endpoint se autentica con una API key mediante la cabecera X-API-Key (formato ek_live_...), en lugar del token bearer del resto de la referencia.

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción
`agent_id`	String (UUID)	Obligatorio	UUID del agente a actualizar.

Cuerpo de la solicitud

Parámetro	Tipo	Obligatorio	Descripción
`agent`	Object	Obligatorio	Objeto con los campos del agente que quieres modificar.
`agent.prompt_config`	Object	Opcional	Configuración estructurada de prompts. Se fusiona parcialmente con el valor existente.
`agent.tools`	Object	Opcional	Configuración de herramientas. Se fusiona parcialmente con el valor existente.
`agent.activation_rules`	Object	Opcional	Reglas de activación o salida. Se fusionan parcialmente con el valor existente.

Ejemplo de solicitud

bash

curl -X PATCH "https://eclectic-api-537143970188.us-central1.run.app/api/external/v2/agents/4b2f7a1e-0e88-4aa7-bf67-7d0a3e0f5b91" \
  -H "X-API-Key: ek_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "agent": {
      "prompt_config": {
        "tone_prompt": "Warm, direct and helpful."
      },
      "tools": {
        "handoff_to_human_control": {
          "enabled": true
        }
      }
    }
  }'

Ejemplo de respuesta

json

{
  "agent": {
    "id": "4b2f7a1e-0e88-4aa7-bf67-7d0a3e0f5b91",
    "name": "Support Agent",
    "type": "BASIC",
    "prompt_config": {
      "tone_prompt": "Warm, direct and helpful."
    },
    "tools": {
      "handoff_to_human_control": {
        "enabled": true,
        "instructions": "..."
      }
    }
  },
  "business_id": "2a4b8d4b-23fa-420a-94c2-cb9a4d2c7fb8"
}

Notas

Los campos JSON prompt_config, tools, data, activation_rules, follow_up_settings e inactivity_run_settings se fusionan parcialmente.
Los valores null se omiten antes de validar y guardar.
PUT está disponible y usa el mismo comportamiento de actualización parcial que PATCH.