Agrega herramientas a agentes personalizados

Note

Este artículo describe características utilizadas en agentes o flujos de agentes alimentados por el arnés estándar.

Las herramientas son bloques de construcción que permiten a tu agente interactuar con sistemas externos. Las herramientas amplían lo que tu agente puede hacer, y este puede realizar diversas acciones en respuesta a solicitudes de los usuarios o activadores autónomos. Cada herramienta representa una funcionalidad específica que el agente puede realizar. Por ejemplo, puedes equipar a tu agente con herramientas que realizan tareas como:

  • Envía correos electrónicos usando el conector 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

¿Herramientas en un agente o capacidades en un plugin?

Las herramientas que añades en Copilot Studio pertenecen a tu agente. Tu agente decide cuándo usarlos y tú los gestionas en Copilot Studio. Un plugin de Microsoft 365 Copilot es diferente: incluye habilidades, herramientas como servidores MCP y agentes para que la gente pueda encontrarlos, instalarlos y gestionarlos juntos en experiencias compatibles con Copilot.

Preguntas y ejemplos Herramientas en tu agente Un plugin de Microsoft 365 Copilot
¿Cuándo usarlo? Estás diseñando la experiencia de un solo agente y las herramientas solo tienen sentido dentro de ella. Quieres que la gente use una capacidad directamente en las experiencias de Copilot en las que ya trabajan.
¿Quién decide cuándo se ejecuta una herramienta? La orquestación, los temas y la configuración de tu agente. Copilot, en cada experiencia soportada.
¿Cómo la usan las personas? Los canales en los que publicas tu agente, como Teams. Experiencias de Copilot compatibles. Cada experiencia utiliza las partes del plugin compatibles.
¿Quién lo gestiona? Los creadores en Copilot Studio. Las políticas de datos de Power Platform controlan qué herramientas pueden añadir los creadores. Administradores, en el Centro de administración de Microsoft 365.
Ejemplo El agente de soporte técnico de TI de Contoso crea tickets y restablece contraseñas en Teams. El plugin de cuentas de cliente de Contoso incluye una habilidad que prepara informes para clientes y un servidor MCP que busca cuentas en el CRM de la empresa. Los vendedores piden a Copilot que "prepare un informe para Fabrikam."

Ejemplo: Herramientas en un agente (agente de soporte técnico de TI de Contoso)

Contoso IT crea un agente en Copilot Studio y lo publica en Teams. El agente utiliza un conector ServiceNow para buscar y crear tickets, un flujo de agente que restablece una contraseña tras la aprobación de un gestor, y un mensaje que resume el historial de tickets. Los temas y la orquestación del agente deciden cuándo se ejecuta cada herramienta, y el restablecimiento de contraseña pide al usuario que confirme primero. El equipo de TI gestiona el agente en Copilot Studio, y las políticas de datos de Power Platform controlan qué conectores pueden utilizar los fabricantes. Las herramientas en un agente encajan aquí porque solo tienen sentido dentro de esta conversación del servicio de ayuda, que Contoso diseña de principio a fin.

Ejemplo: Un plugin (plugin de cuenta de cliente de Contoso)

Contoso Sales incluye un plugin que contiene una habilidad que prepara un resumen para el cliente a partir de la plantilla del equipo, un servidor MCP que busca cuentas en el CRM de Contoso y, opcionalmente, un agente declarativo para revisiones de cuentas. Contoso publica el complemento en su organización y los administradores lo ponen a disposición del equipo de ventas en el centro de administración de Centro de administración de Microsoft 365. Los vendedores piden a Copilot en experiencias soportadas que "preparen un brief para Fabrikam". Copilot utiliza la habilidad y la herramienta CRM, y los vendedores no abren un agente aparte. La primera vez, conectan su cuenta CRM. Un plugin encaja aquí porque la capacidad pertenece a las experiencias de Copilot que los vendedores ya usan, y los administradores la gestionan en un solo lugar.

Para saber más sobre plugins, consulta Plugins.

Mecanismos para añadir herramientas a agentes

Note

Si una herramienta que esperas no está disponible en el panel de Añadir herramienta , las políticas de tu organización podrían restringir las herramientas disponibles para ti. Póngase en contacto con el administrador para obtener ayuda.

Tu agente puede utilizar las herramientas de dos maneras:

  • Orquestación generativa (automáticamente): La orquestación generativa está activada por defecto. Tu agente elige la mejor herramienta, tema o fuente de conocimiento para cada solicitud.

    Ejemplo: Un usuario introduce "Mi portátil no se conecta a la VPN" y el agente elige la herramienta ServiceNow para abrir un ticket.

  • Desde un tema (explícitamente): Llamas a la herramienta desde un nodo dentro de un tema. Si desactivas la orquestación generativa (modo clásico), tu agente responde solo mediante temas, pero los temas aún pueden llamar a herramientas.

Puedes añadir este tipo de herramientas:

Tipo de herramienta Qué hace
Conector predefinido Se conecta a uno de miles de servicios Microsoft y servicios que no son de Microsoft a través de conectores Power Platform.
Conector personalizado Se conecta a tu propio servicio a través de un conector Power Platform que definas. Para que tu agente lo utilice, el conector debe ser visible y compartido en toda tu organización.
Flujo de agente Ejecuta un flujo de una o más acciones.
Prompt Ejecuta un mensaje de modelo de un solo turno. Puede utilizar el conocimiento que proporciones y generar código para analizar datos.
REST API Llama a los puntos finales y métodos que selecciones desde una API REST.
Protocolo de contexto de modelo (MCP) Se conecta a un servidor MCP y utiliza sus herramientas y recursos.
Uso del equipo Gestiona sitios web y aplicaciones de escritorio a través de su interfaz de usuario: seleccionando botones, eligiendo menús e introduciendo texto.

Otras dos opciones dan a tu agente un comportamiento similar a una herramienta:

Las habilidades de Azure Bot Service ponen a disposición de tu agente un conjunto de herramientas relacionadas de un bot de Azure Bot Service. Las herramientas cliente envían una actividad de evento a la aplicación cliente, que realiza una acción y devuelve una respuesta.

Note

Las habilidades en agentes impulsadas por el arnés estándar son habilidades de Azure Bot Service. Son diferentes de las habilidades de agente, que puedes añadir a los agentes impulsados por el arnés GitHub Copilot.

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

Cuando añades una herramienta a tu agente, este puede usarla automáticamente en cualquier conversación.

  1. En Copilot Studio, selecciona Agentes y luego selecciona tu agente.

  2. Ve a la página de Herramientas del agente.

  3. Seleccione Agregar una herramienta.

  4. Selecciona el tipo de herramienta. Para ver todos los tipos, incluyendo la API REST y el conector personalizado, selecciona Ver todo.

    Note

    Si tu organización bloquea un tipo de herramienta, no puedes seleccionarla. Para más información, consulte Herramientas bloqueadas por las políticas de su organización.

  5. Configura la herramienta. Los pasos dependen del tipo. Por ejemplo, para una herramienta de Prompt, escribe las instrucciones de prompt, selecciona un modelo y añade parámetros de entrada seleccionando + Añadir contenido. Puedes obtener ayuda del asistente de indicaciones o empezar desde una plantilla de indicaciones.

  6. Selecciona Guardar y luego selecciona Añadir y configurar.

    Se abre la página de configuración de la herramienta y la herramienta aparece ahora en la página de Herramientas del agente.

    Captura de pantalla de la selección del tipo de nueva herramienta para añadir al agente.

    Note

    Si tu organización bloqueó una herramienta debido a políticas de datos, no puedes seleccionarla. Más información en Herramientas bloqueadas por las políticas de tu organización.

  7. Realice los pasos de configuración específicos del tipo de herramienta que seleccionó. Por ejemplo, si seleccionas Prompt, realiza los siguientes pasos:

    • Define las instrucciones del prompt
    • Selección de un modelo
    • Especificar parámetros de entrada ( seleccionando + Añadir contenido)

    También puedes obtener ayuda escribiendo en el campo Asistente de indicaciones.

    Como alternativa, utiliza una plantilla predefinida para crear un prompt seleccionando plantilla de prompt.

  8. Seleccione Guardar para crear la nueva herramienta.

  9. Seleccione Agregar y configurar. La herramienta se añade a tu agente. Aparecerá la página de configuración de la herramienta. Consulta y haz cambios en la configuración de tu herramienta aquí.

Tu nueva herramienta aparece en la página de Herramientas del agente.

Herramientas bloqueadas por las políticas de tu organización

Los administradores pueden utilizar políticas de gobernanza para limitar qué herramientas y conectores están disponibles en Copilot Studio. Cuando una directiva de datos bloquea una herramienta, esta aparece no disponible en el panel Añadir una herramienta . Para ver qué política lo bloquea, selecciona el icono de información junto a la herramienta. Si necesita una herramienta bloqueada, póngase en contacto con el administrador.

Los administradores gestionan los plugins, incluyendo las habilidades y los servidores MCP que contienen, en Centro de administración de Microsoft 365. Las políticas de datos de Power Platform siguen controlando qué herramientas pueden añadir los creadores en Copilot Studio.

Obtenga más información en Configuración de directivas de datos para agentes.

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

Para ver o cambiar la configuración de una herramienta, vaya a la página Herramientas de su agente y seleccione la herramienta. La página de configuración consta de tres secciones: Detalles, Entradas y Finalización.

Los servidores MCP tienen una página de configuración diferente. En lugar de Inputs y Completion, tiene secciones de Herramientas y Recursos que listan lo que proporciona el servidor MCP. Para más información, consulte Conectar su agente a un servidor MCP existente.

Detalles

Setting Lo que necesita saber
Name Aparece en la lista de herramientas del agente. Usa un nombre que indique lo que hace la herramienta.
Description La orquestación generativa utiliza la descripción para decidir cuándo utilizar la herramienta. Indica qué hace la herramienta y cuándo usarla.
Permitir que el agente decida dinámicamente cuándo usar la herramienta Cuando esté seleccionado, tu agente puede elegir esta herramienta por sí solo. Cuando está desmarcado, tu agente usa la herramienta solo cuando un tema la requiere. Seleccionado por defecto cuando la orquestación generativa está activada.
Pregunta al usuario final antes de ejecutar Pide al usuario que confirme antes de que la herramienta se ejecute. Configurado en No por defecto.
Authentication Ejecuta la herramienta con las credenciales del usuario (Usuario final, por defecto) o las credenciales del creador (proporcionadas por el creador).
Descripción de autenticación Optional. Indica a los usuarios a qué se les pide que inicien sesión.

Ejemplo: Contoso IT describe el proceso de restablecimiento de contraseña como "Restablece la contraseña del usuario después de que su gestor la apruebe. Úsalo si un usuario no puede acceder o pide restablecer su contraseña." También establece Preguntar al usuario final antes de ejecutar a Sí.

Entradas

Las entradas son los valores que tu herramienta necesita. Cada entrada aparece como una fila en una tabla.

Por defecto, Rellenar usando está configurado como Relleno dinámico con IA. Tu agente intenta encontrar cada valor en la conversación, como el mensaje del usuario. Si no encuentra el valor, se lo pregunta al usuario.

Para controlar cómo se recopila una entrada, selecciona Personalizar. Puedes configurar:

  • Nombre de visualización y descripción: cómo aparece la entrada para el usuario.
  • Identifica como: cómo interpretar la respuesta del usuario, por ejemplo como texto o como una entidad predefinida.
  • Lógica de reintento: si preguntar de nuevo si el agente no reconoce la respuesta.
  • Validación de entrada: comprobaciones adicionales más allá del valor predeterminado del tipo de entidad.

Para saltar la pregunta al usuario, configure Rellenar usando como valor Personalizado y, a continuación, introduzca un valor, seleccione una variable o escriba una fórmula de Power Fx.

Note

Después de actualizar una acción de conector, su tipo de salida puede permanecer sin resolver hasta que introduzca todas las entradas necesarias. Introduzca los valores, guarde el tema y luego compruebe de nuevo las variables de salida.

Completion

Elige qué ocurre después de que la herramienta se ejecute. Después de ejecutar, selecciona una de estas opciones:

  • No respondas (predeterminado): Tu agente incluye la salida de la herramienta en su propia respuesta.
  • Escribe la respuesta con IA generativa: La IA escribe una respuesta basada en la salida de la herramienta.
  • Enviar respuesta específica: Escribes una plantilla de respuesta e insertas variables de salida. Puedes formatearlo con Power Fx.
  • Enviar una tarjeta adaptativa: Envías una tarjeta interactiva con botones y acciones.

También puedes elegir qué variables de salida pueden utilizar tu agente y otras herramientas.

Selección de herramientas y recopilación de datos

Tu agente decide si utilizar una herramienta basándose en:

  • El nombre y la descripción de la herramienta.
  • La conversación hasta ahora.
  • Lo que el usuario está pidiendo.
  • Las entradas y salidas que tiene la herramienta.
  • Herramientas que ya ha utilizado en la conversación.

Note

Si una respuesta debe reproducir exactamente la salida de la herramienta, como un enlace o contenido de la tarjeta, use Enviar respuesta específica con inserción de variable o Enviar una tarjeta adaptativa. Usar No responder solo cuando la herramienta ya haya enviado el mensaje visible para el usuario. Escribir la respuesta con IA generativa puede reformular la salida de la herramienta y puede que no preserve exactamente los enlaces o el contenido de las tarjetas.

Configura qué variables de salida poner a disposición del agente y otras herramientas.

Tu agente también utiliza la descripción de la herramienta para escribir preguntas que recopilan entradas faltantes, así que no necesitas añadir nodos de preguntas para cada una.

Por defecto, una herramienta devuelve sus resultados a tu agente, que luego redacta una respuesta. En su lugar, puedes hacer que la herramienta responda directamente al usuario.

Tip

Cuando tu agente haga preguntas generadas por IA, informa a los usuarios de que la IA escribió partes de la conversación. Por ejemplo, agregue un mensaje al tema del sistema Conversation Start.

Llama a una herramienta existente desde dentro de un tema

Usa un tema cuando quieras que una herramienta se ejecute en un punto específico de una conversación.

  1. En Copilot Studio, ve a la página de Temas de tu agente.

  2. Crea un tema y ponle nombre, por ejemplo, Crear un ticket.

  3. Añade frases desencadenantes, como "abrir un ticket", "reportar un problema" y "necesito ayuda de TI".

  4. Selecciona Añadir nodo (+) y luego selecciona Añadir una herramienta.

  5. Selecciona la herramienta. Las herramientas se agrupan en las pestañas Herramientas básicas, Conector y Herramienta .

  6. Seleccione Guardar.

Información del conector MCP

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

Consideraciones de autenticación para herramientas

Algunas herramientas, como los prompts o las que llaman a Dataverse, requieren autenticación. Tu agente ejecuta herramientas en el contexto del usuario, y las herramientas no se ejecutan a menos que la autenticación esté activada. Elige uno de estos métodos:

  • Credenciales de usuario final: Los usuarios solo pueden ver los datos que se les permite ver.
  • Credenciales proporcionadas por el creador: La herramienta utiliza tus credenciales. Utiliza este método para recursos compartidos, o cuando los usuarios no deberían necesitar acceso propio.

Prueba de la herramienta

Al utilizar orquestación generativa, tu agente utiliza la herramienta cuando decide que la herramienta se ajusta a la solicitud. Para probarlo, haz una pregunta que la herramienta debería manejar. En el siguiente ejemplo, Contoso IT escribe "Estoy bloqueado en mi cuenta" y comprueba que el agente solicita confirmación y luego ejecuta el proceso de restablecimiento de contraseña. También puedes probar una herramienta llamándola desde un tópico.

Activar o desactivar una herramienta en tu agente

Una nueva herramienta está activada por defecto. Apagar una herramienta impide que tu agente la use, pero la mantiene conectada para que puedas volver a encenderla más tarde.

  1. Ve a la página de Herramientas de tu agente y selecciona la herramienta.

  2. En la parte superior de la página de configuración, utilice el interruptor Habilitado .

  3. Seleccione Guardar.

Eliminar una herramienta de tu agente

  1. Ve a la página de Herramientas de tu agente.

  2. Pasa el cursor sobre la herramienta y luego selecciona los tres puntos (...).

  3. Selecciona Eliminar y luego selecciona Eliminar nuevamente para confirmar.

Tip

Solo puedes eliminar herramientas desde la página de Herramientas de un agente, no desde la página principal de Herramientas de Copilot Studio.

Limitaciones en el uso de herramientas por parte de los agentes

  • Mediante el uso de orquestación generativa, un agente puede tener hasta 128 herramientas. Para obtener los mejores resultados, usa entre 25 y 30.
  • En la orquestación multiagente, cada agente hijo puede tener sus propias 128 herramientas.