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

URL: https://agentclic.com/docs/agentes/herramientas-y-api
Última revisión: 2026-11-02

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](https://agentclic.com/docs/flujos/que-son-los-flujos) con el paso **Herramienta**. Puedes importar una API desde su documentación, desde un PDF, con un cURL o crearla a mano.

> **Nota:** Herramientas y API forma parte del plan **Agentes ilimitados**. Si tu plan no la incluye, verás un aviso con el botón **«Ver plan Agentes ilimitados»**. Ver [Planes y créditos](https://agentclic.com/docs/primeros-pasos/planes-y-creditos).

## 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](https://agentclic.com/docs/primeros-pasos/planes-y-creditos#creditos). |
| **Mi propia clave LLM** | Conectas tu propio proveedor. Las conversaciones de este agente no consumen créditos. |

### Conectar un modelo con tu clave

1. Elige **Mi propia clave LLM**.
2. Pulsa **«Conectar modelo LLM»**.
3. **Proveedor**: OpenAI, Anthropic, Google Gemini, Mistral, Groq, OpenRouter u **Otro (compatible OpenAI)**. Pulsa **«Continuar»**.
4. **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.
5. Pulsa **«Verificar y cargar modelos»**: se comprueba la clave y se cargan los modelos de tu cuenta.
6. **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 [Resumen del agente y prompt](https://agentclic.com/docs/agentes/resumen-y-prompt#modelo-llm-activo).

> **Consejo:** En **Ajustes › Créditos e IA › Clave LLM propia** decides si cada agente usa su propia clave (**«Una clave por agente»**) o si todos comparten una (**«Una única clave para todos los agentes»**). En el modo de cuenta se usa la primera clave LLM que hayas conectado en cualquiera de tus agentes.

## 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. |
| **PDF** | 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»**.

> **Nota:** Analizar la documentación consume créditos.

### 4. Credenciales

1. Revisa el **Nombre de la conexión** y la **Base URL**.
2. 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»**.
3. Rellena los datos que pida.
4. Pulsa **«Probar conexión»**. Si falla, verás una **Sugerencia de corrección**.
5. 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 [Pasos de un flujo](https://agentclic.com/docs/flujos/pasos-de-un-flujo#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.