> ## Documentation Index
> Fetch the complete documentation index at: https://developers.insuranceboosters.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agentes personalizados

> Ejecuta mediante la API los agentes de IA creados y administrados desde la plataforma.

Los **agentes personalizados** son agentes de IA que tu equipo crea y
administra desde la plataforma de Insurance Boosters.

Desde la plataforma configuras su nombre, instrucciones y herramientas. La API
te permite enviarles un mensaje y utilizar su respuesta desde tus propias
integraciones.

## Flujo recomendado

<Steps>
  <Step title="Configura tu API key">
    Sigue la guía de [Autenticación](/autenticacion) y envía `x-ib-api-key` en cada solicitud.
  </Step>

  <Step title="Obtén tu agentId">
    Abre el agente en la plataforma y copia su identificador.
  </Step>

  <Step title="Ejecuta el agente">
    Envía un mensaje con [Ejecutar agente](/agentes/ejecutar-agente) y usa la respuesta o el handoff.
  </Step>
</Steps>

## Identificador del agente

| Valor     | Descripción                                                                                  |
| --------- | -------------------------------------------------------------------------------------------- |
| `agentId` | Identificador del agente personalizado que quieres ejecutar. Lo encuentras en la plataforma. |

<Note>
  Cada solicitud es independiente: envía **un solo mensaje** por request. Esta API no mantiene ni reutiliza historial entre llamadas.
</Note>

## Autenticación

Incluye tu API key en todas las solicitudes:

```http theme={null}
x-ib-api-key: <tu-api-key>
```

Consulta [Autenticación](/autenticacion) si todavía no tienes una clave.

## Operaciones

<Card title="Ejecutar agente personalizado" icon="play" href="/agentes/ejecutar-agente">
  Envía un mensaje al agente y recibe `response` y, si aplica, `handoff`.
</Card>