> ## 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 IA

> Invoca un agente de IA configurado en tu cuenta y recibe su respuesta.

La API de **Agentes IA** te permite enviar un mensaje a un agente configurado en tu cuenta y obtener su respuesta de forma programática.

## 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">
    Solicita el identificador del agente con tu **ejecutivo de cuenta**.
  </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 que quieres invocar. Solicítalo con tu ejecutivo de cuenta. |

<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" icon="play" href="/agentes/ejecutar-agente">
  Envía un mensaje al agente y recibe `response` y, si aplica, `handoff`.
</Card>