Herramientas Personalizadas
Dar una herramienta a un agente
Asigna una herramienta personalizada a un agente para que pueda usarla durante las conversaciones.
Cuando ya tienes una habilidad en tu caja de herramientas, todavía hay que entregársela a la persona del equipo que la necesita. Una herramienta personalizada que has creado se queda en el estante hasta que se la asignas a un agente: solo entonces ese agente puede usarla cuando habla con alguien.
Image: El paso de Tools en el Panel de Control del Agente con tarjetas de herramientas personalizadas que se pueden activar para el agente
Antes de empezar
- Una herramienta personalizada que ya hayas probado y guardado (consulta Probar una herramienta personalizada).
- Un agente al que quieras darle la herramienta. Si aún no tienes uno, créalo desde la página de Agentes.
- Una idea de qué otras herramientas y bases de datos ya usa ese agente: hay un límite compartido (más abajo).
Paso a paso
- Abre el agente que quieres actualizar en el constructor (Editar en el centro de Agentes).
- Elige Herramientas en el menú de la izquierda.
- Cambia a la pestaña Mis Herramientas. Ahí aparecen todas las herramientas personalizadas que has creado.
- Haz clic en una tarjeta de herramienta para activarla para este agente. Haz clic de nuevo para desactivarla.
- (Opcional) Abre la herramienta desde la tarjeta para revisar su descripción y sus notas de uso: eso es lo que lee el agente para decidir cuándo llamarla.
- Guarda los cambios (cada sección se guarda por separado).
Tu agente ya puede usar esta herramienta en las conversaciones. Cuando alguien pide algo que la herramienta sabe hacer, el agente elige la herramienta, rellena las entradas con lo que dijo la persona, llama al servicio y usa la respuesta en su contestación.
¿Cuántas herramientas puede tener un agente?
No hay límite. Cada herramienta personalizada agrega una, y todas tus bases de datos conectadas comparten un solo conjunto de herramientas de base de datos (como máximo 6, según su permiso). Aun así, mantén la lista enfocada: con menos herramientas para elegir, el agente escoge la correcta con más confiabilidad — quita las que nunca usa.
Cómo decide el agente cuándo usar una herramienta
Cada herramienta personalizada lleva dos piezas de información que el agente lee justo en el momento en que decide qué hacer:
| Lo que lee el agente | De dónde viene |
|---|---|
| La descripción de la herramienta | La frase de "qué hace esto" que escribiste al crear la herramienta. El agente la usa para decidir si la herramienta encaja con la petición del usuario. |
| Las notas de uso | Notas sobre cómo y cuándo llamar a la herramienta, incluidas las advertencias que añadiste. El agente las usa para decidir cómo llamarla, con qué tener cuidado y cuándo evitarla. |
Una descripción clara y específica ("Busca el estado de un pedido de un cliente por número de pedido, incluyendo fechas de envío y entrega") hace que el agente elija la herramienta correcta. Una vaga ("Obtiene info del pedido") le hace adivinar.
Las advertencias también aparecen aquí
Cualquier advertencia que añadiste al construir la herramienta —cosas como "úsala solo para clientes VIP" o "no la llames más de una vez por conversación"— aparece dentro de las notas de uso bajo un bloque de Caveats. El agente las lee antes de cada llamada.
Así que si quieres que el agente sea más prudente o que evite una herramienta en ciertas situaciones, añade una advertencia en la propia herramienta en lugar de intentar gestionarlo desde las instrucciones del agente.
Qué pasa en tiempo real
Cuando un usuario envía un mensaje que coincide con lo que hace una herramienta:
El usuario nunca ve la llamada al servicio: simplemente recibe una respuesta en lenguaje natural basada en lo que devolvió la herramienta.
Ver qué agentes ya usan una herramienta
En la página de Herramientas Personalizadas, cada tarjeta de herramienta muestra cuántos agentes la usan actualmente. Haz clic en la herramienta para ver la lista completa.
Esto es útil antes de editar o eliminar una herramienta: puedes ver exactamente a qué agentes afectaría.
Image: Una tarjeta de herramienta mostrando el indicador "Usada por 3 agentes"
Solución de problemas
| Problema | Solución |
|---|---|
| La herramienta no aparece en la pestaña My Tools del agente | Abre la página de Herramientas Personalizadas y confirma que la herramienta está guardada (no en borrador). |
| Al activar una herramienta sale un mensaje de "límite alcanzado" | El agente ya usó los 25 espacios. Desactiva herramientas o bases de datos que no necesite. |
| El agente no llama a la herramienta cuando esperaba que lo hiciera | Reescribe la descripción de la herramienta para que sea más específica sobre qué hace y cuándo usarla. Guarda y empieza una nueva conversación para probar. |
| El agente llama a la herramienta en el momento equivocado | Añade una advertencia en la propia herramienta (por ejemplo, "úsala solo cuando el usuario pregunte por pedidos abiertos"). Aparecerá en las notas de uso que el agente lee en cada llamada. |
| Eliminé una herramienta y un agente dejó de funcionar bien | Vuelve a crear o restaurar la herramienta, o reescribe las instrucciones del agente para que ya no dependa de ella. |