Herramienta (tool)

Una Herramienta (tool) declara una capacidad que el agente puede invocar por su cuenta cuando lo cree necesario. Se conecta al puerto tools de un AI Agent y podés conectar varias.

Lo potente: una tool puede ejecutar cualquiera de los 600+ nodos de Floogos (generar imágenes, llamar una API, consultar un ERP, leer un Excel…), un workflow entero, o una tool registrada.

Configuración

Campo	Tipo	Requerido	Descripción
tool_name	text	Sí	Nombre de la función que verá el LLM (ej. get_weather). Sin espacios.
tool_description	textarea	Sí	Para qué sirve. El LLM decide cuándo usarla leyendo esto.
tool_schema	json	No	Schema JSON de los parámetros (JSON Schema).
tool_kind	select	Sí	node, workflow o registered.
node_type	text	Cond.	Si tool_kind = node: el tipo de nodo (ej. openaiImages, http).
node_config	json	No	Config base del nodo (se combina con los args del LLM).
workflow_id	text	Cond.	Si tool_kind = workflow: el id del workflow.
tool_id	text	Cond.	Si tool_kind = registered: el id en agent_tools.
attach_to	text	Sí*	Alias del agente.

Una buena descripción es clave

El modelo elige qué tool usar leyendo su tool_description. Sé explícito: qué hace y cuándo usarla. Una descripción vaga = una tool que no se usa (o se usa mal).

Ejemplo 1 — Un nodo como tool (generar imágenes)

1. Herramienta (tool):
   • tool_name: generar_imagen
   • tool_description: “Genera una imagen a partir de una descripción. Úsala cuando el usuario pida crear, dibujar o ilustrar algo.”
   • tool_kind: node
   • node_type: openaiImages
   • tool_schema:

     {
       "type": "object",
       "properties": {
         "prompt": { "type": "string", "description": "Descripción de la imagen" }
       },
       "required": ["prompt"]
     }

2. Conectá su salida al puerto tools.

Ante “dibujame un gato astronauta”, el LLM llama generar_imagen con { prompt: "gato astronauta" }, el agente ejecuta openaiImages y devuelve el resultado.

Ejemplo 2 — Un workflow como tool

Cuando la capacidad es un proceso de varios pasos, envolvelo en un workflow y exponelo como una sola tool.

1. Herramienta (tool) — tool_name: alta_cliente, tool_kind: workflow, workflow_id: 142 (el id de tu workflow de alta).
2. tool_description: “Da de alta un cliente nuevo. Requiere nombre y email.”
3. tool_schema: define nombre y email como parámetros.

El agente ejecuta el workflow 142 con los datos que el LLM extrajo del pedido.

Ejemplo 3 — Consultar un ERP

tool_kind: node, node_type: finnegansGet, y en node_config la credencial/entidad fija; el LLM aporta el filtro. Así el agente puede leer datos de tu ERP durante la conversación.

Precaución

Si la tool falla con “Nodo ‘X’ no encontrado”, revisá que node_type sea el tipo real del nodo (ej. el nodo CSV es csvparce). Si el nodo necesita credenciales, pasalas en node_config.

Ver también

• AI Agent (orquestador) · Skill (para gating de tools)
• Ejemplos y recetas · Problemas frecuentes
• Biblioteca de agentes — skills, tools, prompts y kits listos para insertar en tu agente.