Herramientas y API del agente
Conecta APIs externas a tu agente de Agentclic importando su documentación o a mano, y elige si responde con el modelo de la plataforma o con tu clave.
La pestaña Herramientas del agente sirve para dos cosas: elegir el cerebro del agente (el modelo de la plataforma o tu propia clave LLM) y conectar APIs externas cuyas acciones (endpoints) usan después los flujos con el paso Herramienta. Puedes importar una API desde su documentación, desde un PDF, con un cURL o crearla a mano.
Cerebro del agente: modelo de la plataforma o clave propia
En la tarjeta Cerebro del agente eliges cómo responde este agente. Se configura por agente.
| Opción | Cómo funciona |
|---|---|
| Modelo de la plataforma | Listo para usar, sin configuración. Cada respuesta consume créditos. |
| Mi propia clave LLM | Conectas tu propio proveedor. Las conversaciones de este agente no consumen créditos. |
Conectar un modelo con tu clave
- Elige Mi propia clave LLM.
- Pulsa «Conectar modelo LLM».
- Proveedor: OpenAI, Anthropic, Google Gemini, Mistral, Groq, OpenRouter u Otro (compatible OpenAI). Pulsa «Continuar».
- API key: pega tu clave. El enlace «Obtener API key» lleva a la página del proveedor. Con «Otro», indica también el Endpoint base (compatible OpenAI) y, si quieres, los modelos disponibles.
- Pulsa «Verificar y cargar modelos»: se comprueba la clave y se cargan los modelos de tu cuenta.
- Modelo: elige uno y pulsa «Conectar modelo».
El modelo aparece en Modelo LLM y queda como modelo activo. Con el lápiz («Cambiar modelo») eliges otra versión del mismo proveedor sin volver a escribir la clave; con la papelera lo borras. Si conectas varios, eliges cuál usa el agente en Resumen › Modelo LLM activo. Ver Modelo LLM activo.
Conectar una API
En API / Acciones, pulsa «Nueva conexión API». El asistente tiene cuatro pasos: Origen, Análisis, Selección y Credenciales.
1. Origen
| Origen | Qué haces |
|---|---|
| URL de documentación | Pegas la dirección de la documentación oficial de la API. |
| Subes uno o varios PDF con la documentación. | |
| Datos manuales | Defines una acción con un Formulario (método, URL y parámetros), pegando un cURL o un Script (fetch, axios, Python…). |
| Desde cero | Creas la conexión vacía (nombre, Base URL y carpeta raíz opcionales) y añades los endpoints después con «Crear conexión vacía». |
2. Análisis y 3. Selección
Con URL o PDF, pulsa «Analizar documentación». La IA lee la documentación y te muestra las acciones que ha encontrado. Marca las que quieras («Seleccionar todas» o «Ninguna») y pulsa «Continuar».
4. Credenciales
- Revisa el Nombre de la conexión y la Base URL.
- Elige el Tipo de autenticación. Si la IA lo ha detectado, verás «Método detectado» y, a veces, «Cómo conseguir tus credenciales».
- Rellena los datos que pida.
- Pulsa «Probar conexión». Si falla, verás una Sugerencia de corrección.
- Pulsa «Guardar conexión».
| Tipo de autenticación | Qué te pide |
|---|---|
| Sin autenticación | Nada. |
| API Key en cabecera | El nombre de la cabecera (por ejemplo X-API-Key) y el valor. |
| Bearer token | El token. |
| Basic auth (usuario/contraseña) | Usuario y contraseña. |
| API Key como query param | El nombre del parámetro y el valor. |
| OAuth 2.0 (client credentials) | URL del endpoint de token, Client ID, Client Secret y, opcional, Scope y Audience. |
| Google · Cuenta de servicio | El JSON de la cuenta de servicio, los scopes y, opcional, Subject. |
Gestionar una conexión
Cada conexión se despliega para ver sus acciones, organizadas en carpetas. Con el menú Opciones puedes Renombrar, Editar credenciales o Eliminar conexión (se borran también todas sus acciones).
Dentro de una conexión:
- «Nueva carpeta» y «Nuevo endpoint» para organizar y añadir acciones a mano.
- En cada acción, la casilla Activa decide si se puede elegir en los flujos.
- El botón de probar («Probar endpoint con las credenciales guardadas») hace una llamada real y te muestra la respuesta. Si la acción necesita datos, los rellenas y pulsas «Ejecutar».
- «Configuración avanzada» con las pestañas General, Parámetros, Cabeceras, Query, Body y Ajustes (tiempo máximo de espera y redirecciones).
Usar una API en un flujo
El agente no llama a las APIs por su cuenta: lo hace desde un flujo con el paso Herramienta, en el que eliges la conexión y el endpoint. Ver Herramienta.
Detalles técnicos
- La clave LLM se verifica consultando la lista de modelos del proveedor y se guarda cifrada; no vuelve a mostrarse en el navegador (solo sus cuatro últimos caracteres).
- Los proveedores admitidos funcionan con el formato compatible con OpenAI. «Otro» acepta una URL base o una URL de chat completions.
- El tiempo máximo de espera de un endpoint va de 500 a 120.000 ms.
- Las credenciales de una API se guardan con la conexión; para cambiarlas usa Editar credenciales.
Problemas frecuentes
No me deja elegir «Mi propia clave LLM»
Aparece con una corona: tu plan no incluye la clave LLM propia. Forma parte de Agentes ilimitados.
«No se pudo verificar la clave» o el proveedor no devuelve modelos
Revisa que la clave sea correcta y tenga permisos. Con «Otro (compatible OpenAI)», comprueba el endpoint base.
He elegido clave propia y sigo gastando créditos
Si eliges Mi propia clave LLM sin un modelo activo, el Resumen muestra «Este agente usa tu propia clave LLM, pero no hay ningún modelo activo» y el agente responde con el modelo de la plataforma, que consume créditos. Conecta un modelo y márcalo como activo.
La prueba de conexión devuelve 401 o 403
Un 401 indica que la clave o el token no son correctos o no van en la cabecera esperada. Un 403 suele indicar que faltan permisos o un identificador de cuenta. Revisa el tipo de autenticación en Editar credenciales.
Una acción no aparece en el paso Herramienta del flujo
Comprueba que la casilla Activa de esa acción esté marcada.