OpenAPI Agent
OpenAPI Agent trabaja con un servicio web a partir de su especificación OpenAPI, el documento que describe qué direcciones tiene el servicio y qué datos acepta cada una. Le subes ese documento, le pides algo con tus palabras (“lista los pedidos pendientes”) y el agente consulta la especificación, decide qué llamadas hacer, las ejecuta y te responde con lo que obtiene.
Puede hacer llamadas de lectura y también de creación, modificación y borrado. No añade claves ni credenciales a las llamadas, así que solo sirve con servicios que no piden autenticación. Es un componente antiguo que se mantiene por compatibilidad con flujos existentes.
Cuándo usarlo
- Consultar en lenguaje natural un servicio interno o público que publica su especificación OpenAPI.
- Probar qué puede hacer un servicio web sin escribir las llamadas a mano.
Configuración
| Conexión | Qué conectar |
|---|---|
| Model (obligatorio) | El modelo de IA que interpreta la petición, lee la especificación y decide las llamadas. |
| Campo | Qué hace |
|---|---|
| Input | Lo que quieres hacer o consultar, normalmente desde Chat Input. |
| File Path (obligatorio) | La especificación OpenAPI del servicio. Admite archivos .json, .yaml y .yml. |
| Allow Dangerous Requests (obligatorio) | Autoriza al agente a hacer llamadas reales al servicio. Debe estar activado para que el agente funcione. Por defecto: desactivado. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Handle Parse Errors | Si el modelo devuelve una respuesta con un formato inesperado, el agente intenta recuperarse en lugar de detenerse. Por defecto: activado. |
| Verbose | Registra con detalle los pasos del agente. Por defecto: activado. |
| Max Iterations | Número máximo de pasos (consultas a la especificación y llamadas) antes de detenerse. Por defecto: 15. |
Uso como herramienta de un agente
Puedes conectar este componente a la entrada Tools de un agente. En la pestaña Tool, Tool Name y Tool Description son el nombre y la explicación con los que el agente reconoce la herramienta y decide cuándo usarla: escribe una descripción clara de lo que hace.
Resultado
- Response: la respuesta como mensaje. Conéctala a Chat Output o a cualquier componente que reciba texto.
- Agent: el agente configurado, para conectarlo a componentes que reciban un agente.
Ejemplo
El equipo de sistemas de la cadena de librerías Página Uno tiene un servicio interno de stock, sin autenticación, que publica su especificación OpenAPI:
- Sube la especificación en File Path.
- Conecta un modelo de IA a Model y Chat Input a Input.
- Activa Allow Dangerous Requests.
- Conecta Response a Chat Output.
- Desde el chat, pregunta: “¿Cuántas unidades quedan del libro con referencia 4410 en la tienda de Sevilla?”.
El agente localiza en la especificación la consulta de stock, la ejecuta y responde con las unidades disponibles.
Buenas prácticas
- Úsalo solo con servicios en los que no pase nada grave si el agente crea, cambia o borra datos, o con servicios que solo permitan lectura.
- Para servicios que piden credenciales, usa un componente específico o API Request.
Componentes relacionados
- API Request: hace una llamada concreta a un servicio web.
- Agent: el agente principal de NappAI.