Call API

​

Cuándo usar este nodo

• Extraer datos de herramientas de terceros, CRM, sistemas CMS o plataformas de analítica
• Activar automatizaciones externas o Agents
• Obtener datos estructurados para usarlos en pasos de LLM posteriores
• Enriquecer la ejecución del Agent con lógica de negocio personalizada alojada en otro lugar
• Integrar Profound Agents con API internas o microservicios

​

Configuración del nodo

​

Method (obligatorio)

• GET: obtiene datos de un endpoint de API
• POST: envía datos a un endpoint; permite incluir un cuerpo de solicitud

​

URL (obligatorio)

• Pegar una URL estática
• Insertar variables de forma dinámica con /, haciendo referencia a entradas o a pasos anteriores del Agent

• https://api.example.com/users/{{user_id}}
• https://internal.mycompany.com/search?q={{topic}}

​

Configuración adicional para solicitudes POST

​

Request Body

{
  "userId": 1234
  "action": "create",
  "payload": {
    "firstName": "Jack",
    "email":"jack@example.com"
  }
}

​

Content Type (obligatorio para POST)

• None
• Application/Json

​

Output Label

• api_response
• user_record
• external_data

​

Configuración avanzada

​

Authentication Type (obligatorio)

• None: sin autenticación
• Basic: nombre de usuario y contraseña
• Bearer: bearer token
• API Key: encabezado de API key personalizado

​

Autenticación Basic

• Username
• Password

​

Autenticación Bearer

• Bearer Token

​

Autenticación con API Key

• Header Name
• API Key Value

• Header Name: X-API-Key
• API Key Value: <your_key_here>

​

Resultado

• Pasos de LLM para analizar, extraer o resumir
• Nodos de lógica y transformación
• Llamadas a API posteriores
• Cualquier paso que requiera datos externos estructurados o semiestructurados

​

Ejemplos de uso

​

1. Obtener datos del perfil de usuario

1. Añade un nodo Call API con:
   • Method: GET
   • URL: https://api.example.com/users/{{user_id}}
   • Output Label: user_profile
2. Pasa {{user_profile}} a un paso de LLM para su análisis o transformación.

​

2. Enviar datos del Agent a un servicio externo

1. Añade un nodo Call API con:
   • Method: POST
   • URL: https://hooks.example.com/events
   • Content Type: Application/Json

Request Body:{
  "transcript": "{{video_transcript}}", 
  "summary": "{{summary}}"
}

• Output Label: event_response

​

3. Usar API autenticadas

1. En Advanced settings, elige el tipo de autenticación adecuado.
2. Proporciona las credenciales (por ejemplo, Bearer Token o API Key).
3. Usa GET o POST según sea necesario para obtener datos protegidos.

​

Prácticas recomendadas

• Verifica siempre el método, los encabezados, la estructura del payload y los requisitos de autenticación que espera la API antes de configurar el nodo.
• Usa variables para crear dinámicamente URL o cuerpos de solicitud y obtener Agents más flexibles.
• Al enviar JSON, asegúrate de que el formato sea correcto: un JSON mal formado hará que la solicitud falle.
• Usa etiquetas de resultado descriptivas, especialmente al encadenar varias llamadas a API.

​

Solución de problemas

​

La API devuelve un error

• Que la URL sea correcta
• Los parámetros de consulta obligatorios
• Las credenciales de autenticación
• La estructura del cuerpo JSON (para POST)

​

La respuesta está vacía o no es la esperada

​

Las variables no se resuelven