Refinar la selección de herramientas con descripciones

Completados

Una herramienta adicional solo ayuda cuando el agente la invoca para las solicitudes correctas y deja las demás en manos del conocimiento o de otras herramientas. En esta unidad, aprenderá a refinar el nombre de la herramienta, su descripción y las instrucciones del agente para guiar esa opción y cómo comprobar el resultado en versión preliminar.

Describir la herramienta para su trabajo en su agente

El entorno de ejecución de orquestación mejorado usa el nombre y la descripción de una herramienta para decidir cuándo invocar la herramienta. Un nombre y una descripción predeterminados indican al orquestador lo que hace el conector SharePoint en cualquier agente. No le dicen que, en el agente de ayuda, esta herramienta responde a un empleado que pregunta dónde se encuentra una solicitud o envía una nueva solicitud.

Para cambiar el texto, seleccione la herramienta en el panel componentes de la pestaña Compilar para abrir el cuadro de diálogo Detalles de la herramienta. En el panel Detalles , actualice el nombre y la descripción y, a continuación, seleccione Guardar.

Un nombre y una descripción que guían la selección cubren estos elementos:

  • Un nombre específico: Indica la función de la herramienta, como "Crear ticket de soporte" en lugar de "Herramienta de tickets".
  • Cuándo usarlo: asigne el nombre al tipo de solicitud que controla la herramienta.
  • Lo que necesita: asigne un nombre a la entrada que el agente debe tener antes de llamar a la herramienta, como un número de solicitud.
  • Lo que devuelve: indique lo que vuelve, por lo que el agente sabe lo que puede informar al usuario.
  • Lo que no hace: establezca un límite que separa la herramienta de opciones similares.

Cuando una herramienta de conector proporciona más de una acción, como en el agente de ayuda, escriba la descripción para que indique cuándo se aplica cada acción. En la tabla siguiente se compara una descripción genérica con una escrita para el agente de ayuda.

Elemento Genérico Optimizado para el agente de ayuda
Nombre SharePoint Estado y envío de la solicitud de equipo
Description Funciona con listas de SharePoint. Busque el estado actual de una solicitud de equipo por su identificador de elemento SharePoint o cree una nueva solicitud después de que el empleado confirme los detalles, en la lista de solicitudes de equipo. Utilícelo para preguntas sobre una solicitud que el empleado tiene autorización para ver y para crear nuevas solicitudes. Devuelve el identificador de elemento y el estado de una búsqueda, o el nuevo identificador de elemento para un envío. No responde a preguntas sobre la política de equipos.

La descripción refinada nombra ambos trabajos y los datos de entrada que necesita cada uno, y su frase que delimita el alcance remite las preguntas sobre políticas a otra parte.

Mantenga la descripción precisa de lo que hace la herramienta. Antes de guardar, compare los valores devueltos que se mencionan en la descripción con el panel Outputs, para que la descripción solo indique lo que realmente devuelve la herramienta.

Obtenga más información en Incorporación de una herramienta a un agente.

Herramientas y conocimientos superpuestos independientes

Las descripciones vagas pueden impedir que el entorno de ejecución de orquestación seleccione una herramienta y las descripciones superpuestas lo dejen sin una manera clara de distinguir dos herramientas. Supongamos que más adelante añades una segunda herramienta que devuelve detalles sobre los activos de equipos, y ambas herramientas tienen una descripción como «Funciona con equipos». Un mensaje como «¿Dónde está mi solicitud de muelle?» coincidirá entonces con ambas descripciones por igual. Delimita cada descripción a los registros con los que funciona, como solicitudes o activos, para que la diferencia quede clara.

La misma superposición puede producirse entre una herramienta y un conocimiento. Los documentos de la política de equipos son fuentes de conocimiento, y la búsqueda fundamentada en ellos responde a preguntas sobre la política. Una consulta descrita como "Responde preguntas sobre solicitudes de equipos" da a entender que también abarca cuestiones como "¿Quién tiene derecho a un segundo monitor?". Limita la consulta a la solicitud de un único empleado, identificada por su número de solicitud, para que las preguntas sobre políticas se sigan gestionando en la base de conocimiento.

El conjunto de acciones disponibles también afecta a la selección. Cada acción adicional es otra operación a la que debe tener en cuenta la descripción. Si encuentra una acción que el agente no necesita mientras refina las descripciones, quítela en el panel Entradas del cuadro de diálogo Detalles de la herramienta.

Obtenga más información en Administración y eliminación de herramientas en un agente.

Comportamiento de la herramienta Shape con instrucciones

Las descripciones indican al orquestador para qué sirve cada herramienta. Las instrucciones del agente, que edita en la pestaña Compilar , son la forma principal de controlar cómo se comporta el agente. Indican al agente qué hacer, cómo responder y qué evitar, incluidas las tareas que se deben rechazar o redirigir y cómo controlar la entrada poco clara. En el caso de las herramientas, use instrucciones para indicar cuándo usar o evitar una herramienta y cómo se comporta el agente alrededor de ella.

En el caso del agente de ayuda, la acción de enviar cambia la lista, por lo que conviene que primero confirme los detalles con el empleado. Una instrucción como la siguiente establece esa expectativa:

When an employee asks to submit a new equipment request, collect the request details, repeat them back, and use the equipment request tool to create the request only after the employee explicitly confirms. Don't submit a request on the employee's behalf without that confirmation. If an employee asks about a request's status without a request number, ask for it. Answer equipment policy questions from knowledge without calling a request tool.

En este diseño, el paso de confirmación procede de las instrucciones. Compruebe que el agente solicita confirmación antes de que cree un elemento y no dé por hecho ese comportamiento hasta verlo en Vista previa. Una instrucción de confirmación no concede permiso para leer el elemento de otro usuario; esa restricción debe aplicarse mediante el acceso de la conexión a la lista.

Las instrucciones y descripciones guían la elección del orquestador entre las herramientas que ya tiene el agente. No crean una conexión, conceden acceso a la lista ni garantizan que el orquestador llame a una herramienta determinada. Si no se añade la herramienta o falla su conexión, ningún cambio en la redacción soluciona el problema. Tratarlo como un problema de configuración: confirme que se ha agregado la herramienta y compruebe que sus credenciales están actualizadas y que el servicio está disponible.

Obtenga más información en Configuración de detalles e instrucciones del agente.

Comprobar la selección después de cada cambio

Nombres, descripciones e instrucciones claros mejoran la forma en que el orquestador dirige las solicitudes, pero no garantizan una opción concreta. Después de cambiar cualquiera de ellos, pruebe el agente en la pestaña Vista previa con algunas solicitudes que cada una tiene un resultado esperado:

  • «¿Cuál es el estado de la solicitud 1042?» invoca la consulta de estado de la herramienta.
  • "Necesito una nueva base para portátiles" lleva al agente a recopilar y confirmar los detalles antes de llamar a la herramienta para crear la solicitud.
  • «¿Quién cumple los requisitos para un segundo monitor?» obtiene una respuesta a partir del conocimiento de la política, sin llamar a ninguna herramienta.

La acción de envío crea un elemento que permanece en la lista una vez finalizada la conversación, por lo que se usan datos de prueba mientras se compila.

No es necesario reiniciar la conversación después de cada edición. Cuando editas tu agente en la pestaña Build durante una conversación de vista previa activa, el turno en curso sigue usando la configuración anterior, y el siguiente turno aplica automáticamente tus cambios. Realice un pequeño cambio, envíe un mensaje de seguimiento y compare el resultado con el turno anterior. Si un cambio no surte efecto después de un par de turnos, seleccione Nuevo chat para iniciar una nueva conversación.

Cuando el comportamiento del agente no coincide con el resultado esperado, el síntoma indica dónde mirar primero.

Lo que observa Elementos que se deben comprobar
El agente no invoca la herramienta ante una solicitud que la requiere. Si la descripción de la herramienta describe claramente cuándo usar la herramienta
El agente llama a la herramienta, pero el resultado es incorrecto. Configuración de la herramienta, incluidos parámetros o acciones seleccionadas
La herramienta notifica un error de conexión. Si las credenciales de autenticación están actualizadas y el servicio está disponible

Más información en Prueba a un agente.

Reflect: elija una herramienta en un agente que esté planeando o compilando y vuelva a escribir su descripción para indicar cuándo usarlo, lo que necesita, lo que devuelve y lo que no hace. ¿Qué solicitud enviaría en versión preliminar para comprobar que la nueva redacción cambia la elección del agente?

Más adelante en este módulo, explorará cómo leer el seguimiento de actividad para confirmar qué herramienta se ejecutó con qué entradas y resultados, y cómo identificar qué solicitudes de prueba se mantendrán para la evaluación repetible.