Runnable As Tool
Runnable As Tool convierte un agente o una cadena de tu flujo en una herramienta para otro agente. Así puedes montar un equipo: un agente principal que atiende al usuario y, conectados a él, agentes especialistas a los que consulta cuando hace falta.
Conectas el agente o la cadena especialista a la entrada Runnable, le das un nombre y una descripción, y conectas la salida Tool a la entrada Tools del agente principal. El agente principal decide cuándo pedir ayuda al especialista según la descripción que le des.
Cuándo usarlo
- Un asistente general deriva las preguntas legales a un agente especializado en normativa.
- Quieres separar en agentes distintos la atención comercial y la técnica, con un agente que reparte las consultas.
- Un agente que redacta informes consulta a otro que analiza datos.
- Tienes una cadena que ya funciona bien y quieres que un agente la use como una herramienta más.
Configuración
| Campo | Qué hace |
|---|---|
| Runnable (obligatorio) | El agente o la cadena que se convierte en herramienta. |
| Tool Name | El nombre de la herramienta, tal como lo verá el agente principal. Usa un nombre corto y claro, por ejemplo experto_legal. |
| Input | Los datos con los que se ejecuta el especialista cuando usas la salida Result, escritos entre llaves. Por defecto, {"query": "Question"}. Se oculta al conectar la salida Tool. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Tool Description | Explica al agente principal para qué sirve el especialista y cuándo debe consultarlo. Cuanto más clara, mejor elige el agente. |
| Tool Arguments Schema | Los datos que el agente principal debe enviar al especialista, con su nombre, descripción y si son obligatorios. Si lo dejas vacío, se usan los datos que espera el especialista. |
| Return Direct | Si está activado, la respuesta del especialista se entrega tal cual, sin que el agente principal la reelabore. Solo se aplica cuando rellenas Tool Arguments Schema. Desactivado por defecto. |
| Verbose | No cambia el resultado. Déjalo desactivado. |
Resultado
- Tool: se conecta a la entrada Tools del agente principal.
- Result: la respuesta del especialista al ejecutarlo con los datos de Input. Sirve para probarlo antes de conectarlo como herramienta.
Cuando conectas una de las dos salidas, la otra se oculta.
Ejemplo
Una gestoría quiere un asistente que conteste dudas generales y derive las fiscales a un especialista.
- Crea un agente con instrucciones de experto fiscal y conéctalo a la entrada Runnable de Runnable As Tool.
- En Tool Name escribe
asesor_fiscal, y en Tool Description: “Consulta a este asesor cualquier duda sobre impuestos, declaraciones o plazos con Hacienda”. - Conecta la salida Tool a la entrada Tools del asistente general.
- Un cliente pregunta “¿Cuándo tengo que presentar el IVA del trimestre?”. El asistente general consulta al asesor fiscal y responde con lo que este le dice.
Componentes relacionados
- Agent: el agente principal que usa la herramienta.