Agregar herramientas a agentes personalizados

Las herramientas son los bloques de creación que permiten al agente interactuar con sistemas externos. Las herramientas amplían la funcionalidad del agente, lo que le permite realizar diversas acciones en respuesta a solicitudes de usuario o desencadenadores autónomos. Cada herramienta representa una funcionalidad específica que el agente puede realizar. Por ejemplo, puede equipar al agente con herramientas que hacen cosas como:

• Enviar correos electrónicos mediante el conector de Office 365 Outlook
• Comprobación de las condiciones meteorológicas y las previsiones actuales
• Lectura y escritura de datos de Dataverse
• Leer y publicar mensajes en Teams

Mecanismos para agregar herramientas

Puede ampliar las funcionalidades del agente personalizado agregando una o varias herramientas. El agente puede usar herramientas para responder a los usuarios automáticamente mediante la orquestación generativa. También puede invocar herramientas explícitamente desde un tema.

Con la orquestación generativa (activa de forma predeterminada), el agente puede seleccionar automáticamente la herramienta o el tema más adecuado, o buscar en el conocimiento, para responder a un usuario. Este modo de orquestación crea una experiencia de conversación más dinámica e inteligente.

En el modo clásico (orquestación generativa desactivada), un agente solo puede usar temas para responder al usuario. Sin embargo, todavía puede diseñar el agente para invocar herramientas explícitamente desde los temas.

Hay varios mecanismos disponibles para agregar herramientas al agente:

• Conector: conéctese a API y servicios propietarios mediante conectores de Power Platform para extraer datos o realizar acciones.
  • Conector precompilado: elija entre una selección de conexiones preestablecidas a miles de API conocidas de servicios de Microsoft y que no son de Microsoft.
  • Conector personalizado: defina una conexión a un servicio o sistema personalizado para habilitar las opciones de herramientas personalizadas mediante Conectores de Power Platform. El conector necesita permisos de visualización y uso compartido para que el agente use el conector.
• Flujo de agente: defina un flujo de agente, incluyendo una o más acciones a llevar a cabo.
• Mensaje: mensaje basado en modelo de un solo turno que puede hacer referencia al conocimiento que proporcione y generar código para analizar datos.
• API de REST: defina una conexión a una API de REST y seleccione uno o varios puntos de conexión y métodos de API para agregarlos como herramientas.
• Protocolo de contexto de modelo: conéctese a un servidor MCP para acceder a herramientas y recursos.
• Uso de la computadora: Permite a su agente interactuar con cualquier sistema que tenga una interfaz gráfica de usuario, para sitios web y aplicaciones de escritorio, seleccionando botones, eligiendo menús e ingresando texto en campos en la pantalla.

Hay otros dos mecanismos que puedes usar para agregar un comportamiento de herramienta a tu agente.

• Capacidades: Contenedor para un conjunto de herramientas relacionadas.
• Herramienta cliente: envíe una actividad de evento al cliente para que el cliente realice una acción y devuelva una respuesta.

Para obtener más información sobre las aptitudes y las herramientas de cliente, consulte los vínculos de la sección Contenido relacionado.

Creación y adición de una nueva herramienta en el nivel de agente

La creación de nuevas herramientas directamente en Copilot Studio simplifica el proceso de desarrollo y garantiza una integración adecuada con el agente. Las herramientas agregadas a un agente están disponibles para la orquestación automática a lo largo de todas las conversaciones del agente.

1. Abra su agente eligiendo Agentes en el panel de navegación de la izquierda y seleccionando su agente de la lista.

2. Vaya a la página Herramientas del agente.

3. Seleccione Agregar una herramienta.

4. En el panel Agregar herramienta, seleccione Nueva herramienta.

5. Seleccione el tipo de herramienta que desea agregar en la lista que aparece:

   • Preguntar
   • Flujo de agente
   • Uso del equipo
   • Conector personalizado
   • Protocolo de contexto del modelo
   • API de REST

   

6. Realice los pasos de configuración específicos del tipo de herramienta que seleccionó. Por ejemplo, si selecciona Preguntar, debe realizar los pasos siguientes:

   • Definir la plantilla y las instrucciones de la solicitud
   • Especifique los parámetros de entrada
   • Configurar orígenes de conocimiento
   • Establecer restricciones y formatos de respuesta

7. Seleccione Guardar o Publicar, según corresponda, para crear la nueva herramienta.

8. Seleccione Agregar y configurar. La herramienta se agrega al agente. Aparecerá la página de configuración de la herramienta. Puede ver y realizar cambios en la configuración de la herramienta aquí.

Puede ver la nueva herramienta en la página Herramientas del agente.

Ver y realizar cambios en la configuración de la herramienta

Puede ver y editar la configuración de la herramienta en cualquier momento: vaya a la página Herramientas del agente y seleccione la herramienta en la lista de herramientas.

Se abrirá la página de configuración de la herramienta. Los detalles se muestran en tres secciones:

• Detalles
• Entradas
• Finalización

En el caso de los servidores MCP conectados como herramientas de agente, la página de configuración es diferente de otros tipos de herramientas. La sección Detalles es similar, pero en lugar de Entradas y Finalización, hay secciones Herramientas y Recursos con información sobre las herramientas y recursos disponibles para el servidor MCP. Para obtener más información, consulte Visualización de herramientas y recursos en un servidor MCP existente.

Detalles

La sección Detalles le permite configurar detalles básicos sobre su herramienta.

Aquí puede ver y actualizar:

• Nombre: el nombre de la herramienta. Este nombre aparece en la lista de herramientas del agente. Elija un nombre que indique claramente la función de la herramienta.

• Descripción: una descripción de la herramienta. La orquestación generativa se basa en esta descripción para determinar cuándo debe usar el agente la herramienta. Escriba descripciones claras y específicas que incluyan lo que hace la herramienta y cuándo se debe usar.

• Detalles adicionales:

  • Permitir que el agente decida dinámicamente cuándo usar la herramienta: cuando se selecciona esta opción, el agente puede usar la orquestación generativa para determinar cuándo usar la herramienta. Si no se selecciona esta opción, el agente solo usa la herramienta cuando se llama explícitamente desde un tema. (De forma predeterminada, esta opción se selecciona cuando la orquestación generativa está habilitada).
  • Preguntar al usuario final antes de ejecutar: en la experiencia de chat del usuario final, solicite confirmación al usuario final antes de ejecutar la herramienta. Esta opción está en No de forma predeterminada.
  • Autenticación: seleccione si se van a usar las credenciales del usuario (usuario final) o del creador (proporcionado por el creador) para la herramienta. De forma predeterminada, se aplica la autenticación de usuario.
  • Descripción: opcionalmente, puede agregar una descripción de la herramienta que el agente muestra al usuario cuando desea ejecutar la herramienta. Esta descripción permite al usuario saber lo que se le pide que autentique.

Entradas

Aquí puede ver y configurar las entradas de la herramienta. Las entradas se usan para recopilar información del usuario para rellenar las entradas necesarias para la herramienta. La información se muestra como una tabla, una línea para cada entrada.

De forma predeterminada, el valor de la columna Rellenar con para cada entrada se establece en Rellenar dinámicamente con IA. El agente intenta extraer el valor del contexto disponible, por ejemplo, del mensaje del usuario. Si no se encuentra un valor apropiado, genera una pregunta para pedirle un valor al usuario. Seleccione Personalizar para acceder a personalizaciones más detalladas para la recopilación y el relleno de entradas:

• Nombre para mostrar y Descripción: cómo aparece la entrada al usuario.
• Identificar como: Cómo se interpreta la respuesta del usuario, por ejemplo, como cadena de texto o asignada a una entidad predefinida.
• Reintentar lógica: si el agente no identifica una entidad en la afirmación del usuario, puede volver a formular la pregunta.
• Validación de entrada: configure el comportamiento de validación adicional en la entrada del usuario más allá del valor predeterminado para el tipo de entidad.

También puede optar por invalidar una entrada con un valor explícito en lugar de permitir que el agente lo extraiga. Para definir una sobrescritura, establezca Rellenar usando enValor personalizado e introduzca un valor, seleccione una variable o use una fórmula de Power Fx. Si se anula una entrada, el agente no solicita un valor al usuario.

Finalización

Aquí puede seleccionar lo que desea que suceda cuando la herramienta haya terminado de ejecutarse.

Puede hacer que el agente genere automáticamente una respuesta contextual para un usuario, en función de su consulta y el resultado de la herramienta.

Como alternativa, puede optar por crear una respuesta específica y formateada para que la herramienta la devuelva. Puede insertar referencias a variables de salida desde la herramienta mediante el selector de variables. También puede usar fórmulas de Power Fx para dar formato a la respuesta.

En Después de ejecutar, seleccione una de las diferentes opciones para que responda la herramienta al usuario:

• No responder (predeterminado): el agente incorpora la salida de la herramienta en su respuesta
• Escriba la respuesta con IA generativa: deje que la IA elabore una respuesta contextual utilizando los resultados de la herramienta
• Enviar respuesta específica: redactar una respuesta con plantilla con inserción de variables
• Enviar una tarjeta adaptable: crear respuestas enriquecidas e interactivas con botones y acciones

También puede configurar las variables de salida para que estén disponibles para el agente y otras herramientas.

Selección de herramientas y recopilación de datos

Al definir una herramienta en Copilot Studio, también proporciona información que describe su propósito. Esta información permite al agente identificar cuándo usar la herramienta. La descripción de la herramienta también ayuda al orquestador a usar inteligencia artificial generativa para generar preguntas, según sea necesario, para recopilar entradas. El agente puede usar preguntas para recopilar información para rellenar las entradas necesarias para usar la herramienta. Por lo tanto, no es necesario crear manualmente los nodos de pregunta para recopilar todas las entradas que se requieren, como las entradas de un flujo. El orquestador del agente controla la recopilación de entradas para usted en tiempo de ejecución.

El agente considera varios factores para determinar la selección de herramientas:

• Nombre y descripción de la herramienta
• El contexto actual de la conversación
• Intención del usuario derivada de su mensaje
• Entradas y salidas disponibles
• Uso de herramientas anterior en la conversación

Al usar el modo generativo, de forma predeterminada, las herramientas devuelven su información al agente. Con la respuesta de la herramienta, el agente puede generar una respuesta contextual a la consulta del usuario. Como alternativa, puede indicar a su herramienta que siempre responda de inmediato, ya sea generando un mensaje o creando un mensaje explícito.

Llama a una herramienta existente desde dentro de un tema

Puede llamar a una herramienta explícitamente desde un tema. Dependiendo de su caso de uso, puede usar su herramienta como parte de un tema más amplio, que usa más nodos. O, como en el ejemplo meteorológico, agregar un nodo a un tema puede ser todo lo que necesita.

Para llamar a una herramienta desde un tema:

1. En Copilot Studio, vaya a la página Temas del agente que desea editar.

2. Cree un nuevo tema y asígnele un nombre, por ejemplo, Obtener pronóstico del tiempo.

3. Agregue las frases de desencadenador adecuadas. Para continuar con el mismo ejemplo meteorológico del paso anterior, las frases del desencadenador podrían incluir:

   • ¿lloverá?
   • previsión de hoy
   • obtener pronóstico del tiempo
   • ¿cuál es la previsión meteorológica?

4. Seleccione Agregar nodo (+) y, a continuación, seleccione Añadir una herramienta. Seleccione la herramienta en las herramientas disponibles. Hay tres pestañas que muestran diferentes tipos de herramientas:

   • Herramientas básicas
   • Conector
   • Herramienta

   Su nodo Acción ahora se agrega a su tema.

5. Seleccione Guardar.

Información del conector MCP

Para el conector MCP, puede ver los nombres y descripciones de las herramientas y recursos de MCP que el conector MCP pone a disposición. La información de las herramientas y los recursos se muestra en una tabla, una línea para cada herramienta.

Consideraciones de autenticación para herramientas

Algunas herramientas requieren autenticación para funcionar correctamente, como Dynamic Prompt u otras que llaman a una API Dataverse. La configuración de autenticación adecuada garantiza la seguridad a la vez que se mantiene una experiencia de usuario fluida.

Las herramientas siempre se ejecutan en el tiempo de ejecución del agente en el contexto del usuario y no se pueden ejecutar a menos que la autenticación esté habilitada. Se admiten dos tipos de métodos de autenticación:

• Credentals del usuario final: el agente usa las credenciales del usuario para autenticarse con el servicio. Este método garantiza que los usuarios solo accedan a los datos que están autorizados a ver.
• Credenciales proporcionadas por el creador: el agente usa las credenciales de su autor para autenticarse con el servicio. Use este modo de autenticación para recursos compartidos o cuando los usuarios no necesiten acceso individual.

Probar la herramienta

Con la orquestación generativa, el orquestador selecciona la herramienta cuando considera que es relevante para una consulta de usuario.

Como alternativa, puede llamar a una herramienta existente desde un tema.

Activar o desactivar una herramienta en el agente

Puede activar o desactivar una herramienta para el agente desde la página de configuración de la herramienta. Desactivar una herramienta impide que el agente use la herramienta, pero la herramienta todavía está conectada al agente y se puede volver a activar más adelante. Al agregar una herramienta a un agente, se activa de forma predeterminada.

Para desactivar una herramienta en un agente:

1. Vaya a su agente y seleccione la página Herramientas de su agente.
2. Seleccione la herramienta para ir a la página de configuración de la herramienta.
3. En la parte superior de la página de configuración, desactive la herramienta con el botón de alternancia Habilitado.
4. Seleccione Guardar para aplicar el cambio.

La herramienta sigue apareciendo en la lista de herramientas del agente, pero ya no está activada.

Eliminación de una herramienta del agente

Al desactivar una herramienta se bloquea el uso de la herramienta, pero también se ofrece la flexibilidad de volver a activarla más adelante. También puede quitar una herramienta de forma más permanente del agente. Para eliminar una herramienta del agente:

1. Vaya a su agente y seleccione la página Herramientas de su agente.
2. Busque la herramienta en la lista de herramientas y mantenga el puntero sobre el nombre de la herramienta. Selecciona los tres puntos (...).
3. Seleccione Eliminar. Se abrirá una ventana de confirmación.
4. Seleccione Eliminar para eliminar la herramienta.

La herramienta desaparece de la lista de herramientas del agente.

Contenido relacionado

• Usar conectores
• Solicitudes del usuario
• Usar flujos de agente con el agente
• Protocolo de contexto del modelo (MCP)
• Agregar herramientas desde una API de REST
• Usar capacidades
• Herramientas de cliente
• Uso del equipo (versión preliminar)