Las herramientas se usan para conectar tu agente a sistemas externos o al código intercalado que se le proporciona. Esto permite que tu agente interactúe con otros sistemas para recuperar, actualizar, dar formato o analizar información. En las secciones de esta página, se describen varios tipos de herramientas compatibles.
Cómo crear una herramienta
Para crear una herramienta, haz lo siguiente:
- Haz clic en el ícono de herramienta que se encuentra en el lado derecho del compilador de agentes.
- Selecciona un tipo de herramienta (consulta las descripciones de los tipos de herramientas en este documento).
- Proporciona la información solicitada para la herramienta.
- Usa snake case para el nombre de la herramienta.
- Las descripciones de las herramientas se proporcionan a los modelos de agentes.
Cómo usar una herramienta en un agente
Después de crear una herramienta, debes indicarle a un agente en particular que la use.
- Coloca el cursor sobre un agente.
- Haz clic en Agregar herramienta.
- Selecciona una herramienta.
- Describe cómo se debe usar la herramienta en las instrucciones del agente.
Cómo probar una herramienta
Antes de usar una herramienta en tu agente, puedes probarla en la consola:
- Abre el panel de herramientas.
- Haz clic en el botón Probar herramienta en la parte superior del panel.
Proporciona la entrada para la herramienta según lo define el esquema de la herramienta. Por ejemplo, si el esquema es JSON con propiedades
placeycity, puedes usar la siguiente entrada:{ "place": "automobile repair center", "city": "austin texas" }Haz clic en Enviar. La herramienta se ejecuta con la entrada y se completa la salida.
Después de probar la herramienta directamente, también puedes probarla con el agente de vista previa.
Herramientas disponibles
Las siguientes herramientas están disponibles:
| Herramienta | Descripción |
|---|---|
| Agente como herramienta | Reutiliza las capacidades de los agentes sin transferir a otro agente. |
| Herramientas de funciones del cliente | Herramientas de código que se ejecutan en el cliente, no en el agente. |
| Herramientas de Confluence | Conecta tu agente a una instancia de Confluence. |
| Herramientas de almacén de datos | Proporciona respuestas de agentes generadas por IA basadas en el contenido del sitio web y los datos subidos. |
| Herramientas de búsqueda de archivos | Sube un archivo o proporciona una base de conocimiento RAG a un agente. |
| Herramientas de Google Maps | Conecta tu agente a Google Maps (versión preliminar). |
| Herramientas de Búsqueda de Google | Conecta tu agente al poder de la fundamentación con la Búsqueda de Google. |
| Herramientas de Integration Connectors | Crea herramientas que utilicen tus conexiones configuradas. |
| Herramientas de Jira | Conecta tu agente a una instancia de Jira. |
| Herramientas de MCP | Conéctate a un servidor MCP. |
| Herramientas de OpenAPI | Conéctate a una API externa con un esquema de OpenAPI. |
| Herramientas de código de Python | Proporciona código de Python como herramienta para tu agente. |
| Herramientas de Salesforce | Conecta tu agente a una instancia de Salesforce. |
| Herramientas de Service Now | Conecta tu agente a una instancia de Service Now. |
| Herramientas de SharePoint | Conecta tu agente a una instancia de SharePoint. |
| Herramientas del sistema | Herramientas integradas que el agente puede usar para realizar tareas comunes. |
| Herramientas de widgets | Herramientas de widgets flexibles para crear interacciones enriquecidas con el usuario. |
Tipo de ejecución
Las herramientas admiten dos tipos de ejecución: asíncrona (sin bloqueo) y síncrona (con bloqueo). La selección del tipo de ejecución adecuado depende de la latencia de la herramienta y de la experiencia deseada del agente. Este parámetro de configuración está disponible en la pestaña Avanzado de la configuración de la herramienta.
Tipo de ejecución síncrona
Este tipo se debe usar cuando la ejecución de la herramienta debe bloquear la generación de respuestas del agente hasta que la respuesta de la herramienta esté disponible. El agente no generará ninguna respuesta hasta que la respuesta de la herramienta esté disponible. Lo ideal es que estas herramientas tengan una latencia baja (menos de 5 segundos) para mantener baja la latencia general de respuesta del agente.
Tipo de ejecución asíncrona
Este tipo se debe usar para la ejecución sin bloqueo de herramientas. Cuando se activa una llamada a la herramienta, el agente continuará con una respuesta "pendiente". El agente puede seguir hablando con el usuario mientras se recupera la respuesta de la herramienta. Una vez que la respuesta está disponible, se agrega al contexto la próxima vez que se genera una respuesta del agente. Se usa de forma ideal para herramientas con latencias de respuesta de 5 a 60 segundos.
Flujo de conversación para el tipo de ejecución asíncrona:
- El agente activa la llamada a función: El agente activa una llamada a función y espera una respuesta. Por ejemplo, invoca la herramienta de estado del pedido.
- Respuesta pendiente de la herramienta:
La herramienta muestra de inmediato una
function_responseque contiene un estado pendiente, como"status": "pending". - El agente controla la herramienta pendiente: Se debe indicar al agente que controle las respuestas pendientes según lo desees. Ejemplo de instrucción: "Pregúntale al usuario si tiene alguna otra pregunta mientras recuperas el estado del pedido". Ejemplo de respuesta del agente: "¿Hay algo más que pueda hacer por ti mientras recupero el estado de tu pedido?".
El agente controla la respuesta final: La respuesta real de la herramienta está disponible para el agente. Se incluirá como una etiqueta de contexto. Por ejemplo:
<context>function [<tool_name>] completed with response <response JSON></context>
Prácticas recomendadas
Usa las siguientes prácticas recomendadas para las herramientas:
- Siempre escribe nombres de herramientas semánticamente significativos que sean relevantes para la tarea que realizan.
- Siempre proporciona descripciones de alta calidad de tus herramientas y de las tareas que pueden realizar.
- Para las herramientas asíncronas, incluye instrucciones detalladas para las siguientes situaciones:
- Informa al agente que
es una herramienta asíncrona y que, inicialmente, mostrará una respuesta pendiente. - Incluye instrucciones sobre cómo debe responder el agente cuando la herramienta muestra "pendiente".
- Incluye instrucciones sobre cómo debe responder el agente cuando la respuesta real de la herramienta esté disponible.
- Incluye instrucciones sobre cómo debe responder el agente si la herramienta muestra un error.
- Informa al agente que