Agregar aptitudes a un agente declarativo creado con el Kit de herramientas de agentes de Microsoft 365

Recomendación

Recomendado: Comience con las herramientas de desarrollo de Work IQ para escenarios de complemento y agente declarativo de código profesional compatibles. Consulte el inicio rápido de WIQD. Las instrucciones basadas en el kit de herramientas siguen estando disponibles para los proyectos existentes y los flujos de trabajo que las requieren. Compruebe la compatibilidad con la capacidad y la experiencia de destino antes de elegir una herramienta: WIQD no se dirige a agentes de motor personalizados.

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.

Una aptitud es un componente modular que se agrega a un agente declarativo para empaquetar instrucciones, recursos y scripts para una tarea específica. Durante la compilación o reutilización, use este artículo cuando el proyecto elegido ya use Microsoft 365 Agents Toolkit (ATK). Finaliza con una aptitud registrada en el agente, instrucciones de tarea guardadas y una versión de prueba aprovisionada.

Para un nuevo proyecto de complemento de desarrollador profesional, comience con las herramientas de desarrollo de Work IQ y un entorno documentado. Mantenga este procedimiento del kit de herramientas cuando los controles del proyecto se ajusten a la ruta del agente seleccionado; No es un requisito para todos los complementos.

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.

Esta guía agrega aptitudes de ámbito de agente. Para distribuir una aptitud para usarla directamente en Copilot Chat a través de un complemento, consulte Creación de aptitudes para Copilot Chat.

Importante

En esta guía se supone que ha completado el tutorial de creación de agentes declarativos mediante el kit de herramientas de agentes de Microsoft 365 y JSON . Agregar una aptitud requiere el manifiesto de agente declarativo versión 1.9. Si está utilizando un agente creado con una versión anterior de Agents Toolkit, es posible que tenga que actualizar la versión de su manifiesto de agente. Para obtener más información, vea Referencia de manifiesto de agente declarativo.

Requisitos previos

Habilitar habilidades de agente

El soporte de habilidades del agente está controlado por la variable de TEAMSFX_AGENT_SKILLS entorno. Establézcala antes de iniciar la CLI o Visual Studio Code.

  • Windows (PowerShell): para conservar la variable entre sesiones, agréguela a las variables de entorno de usuario:

    [System.Environment]::SetEnvironmentVariable("TEAMSFX_AGENT_SKILLS", "true", "User")
    
  • macOS o Linux: establezca la variable:

    export TEAMSFX_AGENT_SKILLS=true
    

    Para conservar la variable, agregue la línea a su export~/.bashrc~/.zshrcperfil de shell , o equivalente.

Si establece la variable después de instalar la extensión de Visual Studio Code, reinicie Visual Studio Code por completo.

Verificar: El proceso de herramienta reiniciado se establece TEAMSFX_AGENT_SKILLS en true. Una configuración de Windows a nivel de usuario no cambia un proceso que ya se estaba ejecutando.

Agregar una aptitud a su agente

  1. En el proyecto existente, agregue una aptitud. Para crear una aptitud, proporcione un nombre y una descripción:

    atk add skill --name skill-name --description description
    

    Para agregar una carpeta de habilidades existente, use la --from opción:

    atk add skill --from PATH_TO_SKILL
    

    Verificar: El proyecto contiene el directorio de aptitudes y SKILL.md, y el manifiesto del agente declarativo hace referencia a esa aptitud. Siga la matriz de soporte; Esta opción de importación no establece la reutilización entre agentes.

  2. Edite las aptitudes SKILL.md con las instrucciones de la tarea, los recursos y los scripts admitidos.

    Verificar: El archivo guardado conserva sus metadatos necesarios y describe la tarea, la salida esperada y los límites.

  3. Aprovisione el agente declarativo para que esté disponible en su entorno:

    atk provision --env local
    

    Verificar: El aprovisionamiento se realiza correctamente para el inquilino y el entorno previstos. Probar la tarea de la habilidad en el agente previsto; El aprovisionamiento correcto no establece el comportamiento en tiempo de ejecución.

Límites

En el kit de herramientas de agentes, agrega una aptitud como directorio (no puede usarla .zip) y el paquete completo de la aplicación está limitado a 10 MB. Puede agregar hasta ocho habilidades por agente, con una profundidad máxima de directorio de tres y hasta 350 archivos en todas las habilidades. Para obtener la matriz de soporte completa, consulte Habilidades en agentes declarativos.

Publicar el agente

Los proveedores de software independientes (ISV) pueden enviar agentes declarativos que incluyan aptitudes a Microsoft Marketplace. Use las herramientas de desarrollo de Work IQ para validar y crear el paquete submittable a partir de un proyecto de agente declarativo existente. Para los paquetes de complementos, wiqd publish pc puede crear la oferta del Centro de partners, rellenar la lista de borradores, cargar el paquete y las imágenes, enviar para su certificación con autorización independiente y realizar un seguimiento del estado. La inscripción y la comprobación de la cuenta del Centro de partners siguen siendo pasos del portal y Microsoft controla la certificación y la publicación.

Sigue la publicación en el Centro de partners con WIQD para obtener información sobre los requisitos previos, la validación de paquetes, la configuración de la lista, el envío y el seguimiento del estado. El envío del portal sigue siendo una alternativa; consulta la guía de envío de Microsoft Marketplace. Siga la ruta de envío del agente confirmado, no un ejemplo de complemento de Office o un tipo de oferta supuesto para complementos compuestos.

Siguiente paso

Ingrese el paquete & prueba con Integre y pruebe los componentes. Cuando el agente esté listo para la distribución pública, continúe publicando a través de Microsoft Marketplace.