Tool Calling Agent
Tool Calling Agent responde a cada mensaje con el modelo de IA que le conectes y, cuando lo necesita, usa las herramientas disponibles (buscar información, consultar una base de datos, llamar a otro servicio) antes de contestar. Además de las herramientas que conectes, siempre dispone de una para consultar la fecha y hora actuales.
Es un componente antiguo que se mantiene por compatibilidad con flujos existentes. Para flujos nuevos usa Agent.
Cuándo usarlo
- Mantener flujos existentes construidos con este agente.
- Un asistente que consulta sistemas externos a través de herramientas antes de responder.
- Un asistente que necesita saber la fecha del día, por ejemplo para calcular plazos.
Configuración
| Conexión | Qué conectar |
|---|---|
| Model (obligatorio) | El modelo de IA que responde y decide qué herramientas usar. |
| Tools | Las herramientas que el agente puede usar. |
| Chat History | Los mensajes anteriores de la conversación, por ejemplo desde Chat Memory, para que el agente los tenga en cuenta. |
| Campo | Qué hace |
|---|---|
| Input | El mensaje del usuario, normalmente desde Chat Input. |
| System Prompt | Las instrucciones del agente. Por defecto: “You are a helpful assistant”. |
| Prompt | La plantilla del mensaje que recibe el agente. Debe contener {input}, que se sustituye por el contenido de Input. Por defecto: {input}. |
| Executor Name | Nombre con el que aparece el agente en el registro de las ejecuciones. Por defecto: tool_calling_agent. |
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 (llamadas a herramientas) antes de detenerse. Por defecto: 15. |
| Disable Streaming | Hace que el modelo entregue la respuesta completa de una vez en lugar de ir mostrándola. Por defecto: desactivado. |
| Early Stopping Method | Qué ocurre al llegar a Max Iterations. Con None (por defecto) o force, el agente se detiene y responde con un aviso de que ha alcanzado el límite de pasos. Los flujos guardados con la antigua opción generate se comportan como force. |
Algunas versiones antiguas del componente no muestran Executor Name ni Early Stopping Method.
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
La empresa de mensajería Envíos Rápidos quiere un asistente que informe del estado de los paquetes:
- Conecta Chat Input a Input y un modelo de IA a Model.
- Conecta a Tools la herramienta que consulta el estado de los envíos.
- En System Prompt escribe: “Eres el asistente de Envíos Rápidos. Pide el número de seguimiento y consulta su estado antes de responder.”
- Conecta Response a Chat Output.
Cuando un cliente da su número de seguimiento, el agente consulta el envío y responde con su estado y, si hace falta, cuántos días faltan para la entrega según la fecha de hoy.
Buenas prácticas
- Conecta solo las herramientas que el agente necesita: cuantas menos tenga, mejor elige.
- Si el agente se detiene sin terminar en tareas largas, sube Max Iterations.
Componentes relacionados
- Agent: el agente recomendado para flujos nuevos.
- OpenAI Tools Agent: otro agente antiguo con herramientas.