Llamar a una API
Llama a APIs externas directamente desde el agente.
Llamar a una API
Permite que el agente haga peticiones HTTP a APIs externas, con el método, las cabeceras y el cuerpo definidos en la configuración. El agente decide el cuerpo de la petición a partir del contexto de la conversación.
Configuración
| Campo | Obligatorio | Qué es |
|---|---|---|
| Endpoint de la API | Sí | La URL completa del endpoint que llamar (p. ej. https://api.ejemplo.com/v1/clientes) |
| Método HTTP | Sí | El método de la petición: GET, POST, PUT, DELETE o PATCH |
| Cabeceras (JSON) | No | Las cabeceras de la petición como objeto JSON (p. ej. { "Authorization": "Bearer token123", "Content-Type": "application/json" }) |
Cómo funciona
Ante una tarea que involucre esa API, el agente:
- Usa el endpoint y el método configurados.
- Aplica las cabeceras de la configuración.
- Decide el cuerpo de la petición a partir del contexto de la conversación.
- Devuelve el estado HTTP y los datos de la respuesta.
Parámetros de entrada (en tiempo de ejecución)
| Parámetro | Qué es |
|---|---|
| Cuerpo | El cuerpo de la petición (para POST, PUT y PATCH). El agente lo rellena a partir del contexto |
Respuesta
| Campo | Qué es |
|---|---|
| Estado | El código HTTP de la respuesta (200, 201, 404) |
| Datos | Lo que devolvió la API |
consejo
Usa la descripción de la acción para decirle al agente qué hace la API y cuándo usarla. Cuanto más precisa sea, mejor decide el agente cuándo y cómo llamar al endpoint.