Agregar herramientas a agentes personalizados

2025-06-16

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 llamar a herramientas explícitamente desde un tema.

Con la orquestación generativa (activa de forma predeterminada), el agente puede seleccionar automáticamente la herramienta o tema más adecuado, o buscar entre conocimientos, 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, aún puede diseñar su agente para llamar a herramientas explícitamente desde los temas.

Hay varios mecanismos disponibles para agregar herramientas al agente:

Conector precompilado: elija entre una selección de conexiones preestablecidas a miles de API populares de los servicios de Microsoft y que no son de Microsoft.
Conector personalizado: defina una conexión a un servicio o sistema personalizados para habilitar las opciones de herramientas personalizadas mediante Power Platform Connectors.
Flujo del agente: defina un flujo de agente, incluidas una o varias acciones que se van a llevar a cabo.
Aviso: aviso basado en modelo de turno único que puede hacer referencia al conocimiento que proporcione.
Conexión de API REST: defina una conexión a una API REST y seleccione uno o varios puntos de conexión y métodos de API para agregar como herramientas.
Herramienta Protocolo de contexto de modelo (MCP): conéctese a un servidor MCP para acceder a las herramientas.
Agente de uso de equipos (versión preliminar): permite al agente interactuar con cualquier sistema que tenga una interfaz gráfica de usuario, para sitios web y aplicaciones de escritorio, seleccionar botones, elegir menús y escribir texto en campos en la pantalla.

Cuando hablamos sobre las herramientas de este artículo y esta sección de la documentación, nos referimos a uno de los mecanismos de este grupo. Estos tipos de herramientas se pueden agregar al agente y configurarlos de maneras similares.

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.

Abra su agente eligiendo Agentes en el panel de navegación de la izquierda y seleccionando su agente de la lista.
Vaya a la página Herramientas del agente.
Seleccione Agregar una herramienta.
En el panel Agregar herramienta , seleccione Nueva herramienta.
Seleccione el tipo de herramienta que desea agregar en la lista que aparece:
- Aviso: Creación de herramientas de análisis y generación de texto con tecnología de IA
- Flujo del agente: compilación de procesos de varios pasos con lógica condicional
- Uso del equipo: Habilitación de la automatización de GUI para sistemas heredados
- Conector personalizado: conexión a api y servicios propietarios
- API REST: integración directa con servicios web
Realice los pasos de configuración específicos del tipo de herramienta que seleccionó. Por ejemplo, si selecciona Preguntar, debe realizar los pasos siguientes:
- Definición de la plantilla de solicitud e instrucciones
- Especificar parámetros de entrada
- Configurar orígenes de conocimiento
- Establecer restricciones y formatos de respuesta
Pruebe la configuración de la herramienta mediante el panel de vista previa para asegurarse de que funciona según lo previsto.
Seleccione Guardar para crear la nueva herramienta.
Seleccione Agregar al agente para agregar la herramienta al agente. Puede ver la nueva herramienta en la página Herramientas del agente.

Visualización y realización de 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 abre la página Detalles de la herramienta, en la que se muestra la configuración de la herramienta. Los detalles se muestran en tres secciones:

Detalles
Entradas
Finalización (Herramientas para conectores MCP)

Detalles

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

Aquí puede ver y actualizar:

Nombre: el nombre de la herramienta. Este nombre aparece en la lista de herramientas de tu agente. Elija un nombre que indique claramente la función de la herramienta.
Descripción: 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 en particular. (De forma predeterminada, esta opción se selecciona cuando la orquestación generativa está habilitada).
- Pregunte al usuario final antes de ejecutar: en la experiencia de chat del usuario final, pida al agente confirmación antes de ejecutar la herramienta. Esta opción se establece en No de forma predeterminada.
- Autenticación: seleccione si se van a usar las credenciales del usuario o del 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 se muestra al usuario cuando se ejecuta 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 manera predeterminada, el valor de la columna Rellenar usando para cada entrada se establece en Relleno dinámico 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 específicas para la recopilación y el llenado 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.
Lógica de reintento: si el agente no identifica una entidad en la instrucció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 en Valor personalizado e introduzca un valor, seleccione una variable o use una fórmula de Power Fx. Si se invalida una entrada, el agente no solicita al usuario un valor.

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, puedes optar por crear una respuesta específica con formato para que tu 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 ejecutarse, seleccione una de algunas opciones diferentes para saber cómo debe responder la herramienta al usuario después de que se ejecute la herramienta:

No responda (valor predeterminado): el agente incorpora la salida de la herramienta en su respuesta.
Escritura de la respuesta con ia generativa: Permitir que la inteligencia artificial cree una respuesta contextual mediante las salidas de la herramienta
Enviar respuesta específica: crear 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 de entrada

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 y también usar inteligencia artificial generativa para generar preguntas. Estas preguntas se usan para recopilar información para rellenar las entradas necesarias para realizar 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. La recopilación de entrada se gestiona automáticamente en tiempo de ejecución.

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

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

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

Propina

Al utilizar preguntas generadas por una herramienta, informe a los usuarios de que parte de las conversaciones se generan mediante IA.

Por ejemplo, agregue un mensaje adicional en el tema Sistema de inicio de conversación . Este tema determina el mensaje que se muestra a sus usuarios cuando comienza una nueva conversación.

Llama a una herramienta existente desde dentro de un tema

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

Para llamar a una herramienta desde un tema:

En Copilot Studio, vaya a la página Temas del agente que desea editar.
Cree un nuevo tema y asígnele un nombre Obtener pronóstico del tiempo.
Agregue las siguientes frases desencadenadoras:
- lloverá
- pronóstico de hoy
- obtener pronóstico del tiempo
- ¿cuál es la previsión meteorológica?
Seleccione Agregar nodo (+) y, a continuación, seleccione Agregar una herramienta. Seleccione la herramienta en las herramientas disponibles. Hay tres pestañas que muestran diferentes tipos de herramientas:
- Herramientas básicas
- Conector
- Herramienta
El nodo Acción ahora se agrega al tema.
Seleccione Guardar.

Herramientas (solo conectores MCP)

En Herramientas, puede ver los nombres y descripciones de las herramientas que están disponibles para el conector MCP. Las herramientas se muestran en una tabla, una línea para cada herramienta. Para cada herramienta, puede ver:

Nombre y versión de la herramienta
Parámetros de entrada y salida
Tiempo de ejecución estimado
Estadísticas de uso

Consideraciones de autenticación para herramientas

Algunas herramientas requieren que la autenticación funcione correctamente, como la solicitud dinámica u otras que llaman a una API de 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 de usuario y no se pueden ejecutar a menos que la autenticación esté habilitada. Se admiten dos tipos de métodos de autenticación:

Autenticación de usuario: 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 para ver.
Autenticación del autor de Copilot: 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.

Prueba de 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.