Agregue habilidades a su agente declarativo en Agent Builder

Una aptitud es un componente modular y reutilizable que se agrega a un agente declarativo para ayudarlo a realizar una tarea empaquetada específica. Una aptitud es un directorio que contiene un archivo necesario SKILL.md con instrucciones, además de scripts y archivos de recursos opcionales. En este artículo se describe cómo agregar una aptitud a un agente integrado en Agent Builder, ya sea describiendo la aptitud en lenguaje natural o cargando un paquete de aptitudes.

Para saber qué son las aptitudes, por qué usarlas y la matriz de soporte completa, los tipos de archivo admitidos, el comportamiento del espacio aislado y la gobernanza, consulte Habilidades en agentes declarativos.

Para una aptitud personal que se usa directamente en Copilot Chat sin un agente, consulte Crear habilidades para Copilot Chat. Los pasos y límites de carga de este artículo se aplican a Agent Builder, no a las cargas de chat personales.

Importante

En los inquilinos que usan barreras de información (IB) de Microsoft Purview, los administradores pueden implementar agentes declarativos con aptitudes, pero los usuarios finales no pueden agregar aptitudes a los agentes declarativos que crean.

Requisitos previos

  • Una suscripción de Microsoft 365 válida que proporcione acceso a Microsoft 365 Copilot Chat. No se requiere una licencia de complemento de Microsoft 365 Copilot. Algunas funcionalidades del agente requieren una licencia de Microsoft 365 Copilot o pago por uso. Para obtener más información, consulte Funcionalidades del agente y modelos de licencia.

Nota

En Agent Builder, puedes agregar hasta ocho habilidades por agente, y cada paquete de habilidades es un archivo comprimido .zip de hasta 50 MB. Para conocer la matriz de soporte completa y los límites, consulte Habilidades en agentes declarativos.

Crear una aptitud a partir de una descripción

Puede pedir a Agent Builder que cree una aptitud reutilizable a partir de una descripción en lenguaje natural.

  1. En Copilot Chat, seleccione Agentes & Aptitudes y, a continuación, seleccione Nuevo agente.

  2. Selecciona el cuadro de texto Message Agent Builder y pide a Agent Builder que cree un flujo de trabajo reutilizable.

    Create an agent that helps my team write release notes. Add a reusable skill that always follows the same steps:
    
    1. Takes a list of merged changes (a pasted list or an uploaded  .csv  of PR titles).
    2. Groups them into Features, Fixes, and Other.
    3. Runs a script to format them into a clean Markdown changelog with a version heading and today's date.
    
    Package this as a skill with clear instructions and the formatting script so the output looks the same every time.
    

    Captura de pantalla de la solicitud de Agent Builder para crear un agente

  3. En la pestaña Configurar , confirme que se ha creado una aptitud.

    Captura de pantalla de la pestaña Configurar de Agent Builder en la que se muestra una aptitud adjunta

  4. Seleccione la habilidad para revisar sus detalles.

    Captura de pantalla de los detalles de la aptitud recién agregada

Si no se agrega la habilidad, puede agregar habilidades explícitamente cargando un paquete de habilidades.

Cargar un paquete de aptitudes

Para agregar un paquete de habilidades, primero crea el paquete y luego cárgalo en Agent Builder.

Crear su paquete de aptitudes

Antes de agregar una habilidad en Agent Builder, empaqueta la habilidad como un .zip archivo que contenga:

  • Un archivo necesario SKILL.md .
  • Un nombre y una descripción de la aptitud en la SKILL.md portada de YAML.
  • Archivos de recursos admitidos opcionales.
  • Scripts compatibles opcionales y carpetas auxiliares.
  • Instrucciones de habilidad de menos de 20,000 caracteres.

El paquete es similar a la siguiente estructura de directorios:

my-skill.zip
|-- SKILL.md              # required
|-- <resource files>      # optional
`-- <scripts or folders>  # optional

Para obtener información sobre los tipos de archivos y scripts admitidos, consulte Tipos de archivos y scripts compatibles.

Importante

Carga el paquete completo .zip . No cargar SKILL.md solo.

Cargue su paquete de aptitudes

  1. Abra o cree un agente declarativo en Agent Builder.

  2. En la pestaña Configurar , expanda Aptitudes y, a continuación, seleccione Agregar.

    Captura de pantalla del botón Agregar en la sección Habilidades del panel Configurar de Agent Builder

  3. Cargue el paquete completo .zip de habilidades.

  4. Revise el nombre de la aptitud, la descripción, las instrucciones y los archivos incluidos.

  5. En la pestaña Pruébelo , pruebe un mensaje que deba usar la habilidad.