Dar una herramienta a un agente
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 Panel de Control del Agente y selecciona el agente que quieres actualizar.
- Haz clic en el paso de Tools dentro de la configuración del agente.
- Cambia a la pestaña My Tools. 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 el agente.
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.
El límite compartido de 25 herramientas
Cada agente tiene un cupo de 25 espacios de herramientas. Las herramientas personalizadas y las conexiones de base de datos salen del mismo cupo.
| Lo que le das al agente | Espacios usados |
|---|---|
| Una herramienta personalizada | 1 |
| Una conexión de base de datos de solo lectura | 2 |
| Una conexión de base de datos de solo escritura | 5 |
| Una conexión de base de datos completa (lectura y escritura) | 7 |
Así que un agente con una conexión de base de datos completa (7) y tres herramientas personalizadas (3) está usando 10 de los 25 espacios. Si intentas activar una herramienta que te pasaría de 25, la página te dirá cuáles debes desactivar primero.
Si tu agente choca contra el límite, busca herramientas personalizadas que nunca llega a usar. Quitar esas suele liberar espacio suficiente para las que sí importan.
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. |
Qué sigue
Probar una herramienta personalizada
Vuelve a ejecutar una prueba de una herramienta ya asignada para asegurarte de que sigue funcionando.
Usar una plantilla de herramienta
Añade otra herramienta al estante partiendo de una configuración predefinida.
Resumen de Herramientas Personalizadas
Vuelve al resumen para ver todas las formas de construir una herramienta personalizada.