Crear o reutilizar habilidades

Si tiene una tarea que se puede repetir y una experiencia de Microsoft de destino, use este artículo para decidir si quiere desarrollar una aptitud o adaptar el contenido de aptitudes existente. A continuación, elija los pasos de creación del producto. Está en Compilar o reutilizar. Su resultado es una implementación de habilidades con sus dependencias y evidencia de prueba, lista para la integración antes de la prueba del Paquete &.

Reutilizar o ampliar una aptitud

Para los agentes declarativos, Agent Builder y Agents Toolkit no admiten la reutilización entre agentes. Siga la matriz de soporte en Habilidades en agentes declarativos; No asuma que una aptitud asociada a un agente se puede compartir con otro.

Antes de crear una aptitud:

  1. Revise las aptitudes aprobadas que ya realizan el trabajo requerido.
  2. Confirme que el agente de destino o la experiencia de Microsoft admite las capacidades y el formato de aptitud.
  3. Revise sus instrucciones, recursos, scripts, herramientas y acceso a datos.
  4. Compruebe los límites de reutilización documentados de la experiencia de destino antes de adaptar el contenido de aptitudes existente.
  5. Confirme las expectativas de propiedad, control de versiones, uso compartido, soporte técnico y actualización.
  6. Pruebe la habilidad con entradas representativas y salidas esperadas.

Crear una nueva aptitud cuando ninguna aptitud aprobada existente cumpla los requisitos o la experiencia de destino no admita la reutilización.

Elegir la ruta de acceso de implementación

Comience con las herramientas de desarrollo de Work IQ para el desarrollo profesional. Elija la ruta para su experiencia de destino y tipo de proyecto; Un formato compartido SKILL.md no establece la reutilización entre agentes ni la elegibilidad de publicación.

Enfoque de desarrollo Artefacto y ámbito de la aptitud Empezar con
Herramientas de desarrollo de Work IQ Una carpeta de habilidades de nivel superior en un complemento independiente o una habilidad agregada a un proyecto de agente declarativo existente. Se trata de rutas de creación independientes. Cree un complemento con las herramientas de desarrollo de Work IQ y los detalles de la ruta a continuación
Creación de aptitudes de Copilot Chat y distribución de complementos Siga las instrucciones de creación y distribución específicas del producto. Crear habilidades para Copilot Chat
Generador de agente Un ZIP de aptitud completo cargado en un agente declarativo o una aptitud creada a partir de una descripción en Agent Builder. Agregar habilidades con Agent Builder
Kit de herramientas de agentes de Microsoft 365 Un directorio de aptitudes agregado a un proyecto de agente declarativo existente, no un archivo zip de aptitudes independiente. Agregar habilidades con el Kit de herramientas de agentes
Copilot Cowork Carpetas de aptitudes registradas en un paquete de la aplicación Microsoft 365. Utilice los requisitos y límites del paquete de Cowork. Compilar complementos para Copilot Cowork

Hacer coincidir el artefacto con su ruta de publicación

Siga las instrucciones de publicación del artefacto:

La compatibilidad con un artefacto no establece la elegibilidad de publicación para cada paquete de complementos. La publicación no completa el acceso, el consentimiento o la configuración de conexión del usuario.

GitHub Copilot puede ayudar con instrucciones de aptitudes, admitiendo scripts, recursos, pruebas y cambios en el repositorio. La experiencia de destino y la herramienta de creación determinan el formato y el tiempo de ejecución de aptitudes admitidos.

Herramientas de desarrollo de Work IQ

WIQD proporciona dos rutas diferentes de creación de aptitudes.

  • wiqd plugin add skill Agrega una aptitud de nivel superior a un proyecto de complemento independiente. El complemento puede ser solo de aptitudes o combinarlo con agentes compatibles o conectores MCP remotos. Confirme el soporte del producto de destino por separado.
  • wiqd agent add skill Agrega una aptitud a un proyecto de agente declarativo existente. Esta ruta utiliza la marca de agent-skills entidad, que está desactivada de forma predeterminada.

Ambas rutas crean una SKILL.mdcapacidad basada en -, pero operan en diferentes tipos de proyecto. En el formato del complemento WIQD, el nombre de la habilidad debe coincidir con el nombre de su carpeta y su descripción debe incluir las frases que la activan. Consulte ¿Qué es un complemento? y la referencia de creación de complementos.

La validación de origen de WIQD (wiqd plugin validate --mode source) no inspecciona el contenido de aptitudes. Después del empaquetado, ejecute wiqd plugin validate --mode package --package-file "<path-to-existing-zip>" con la ruta de acceso ZIP real. La validación de paquetes carga una copia capturada de ese archivo zip en el servicio de validación de Microsoft 365 y puede requerir autenticación. Revisar los hallazgos devueltos; Un pase no establece el comportamiento en tiempo de ejecución. Ver Validación y MVL.

Implementar la aptitud

Complete el trabajo correspondiente:

  1. Defina el trabajo, las entradas, los resultados esperados, los límites y los criterios de éxito.
  2. Cree o importe las instrucciones de aptitudes.
  3. Agregue los scripts y los recursos auxiliares necesarios.
  4. Configure cualquier herramienta, servidor MCP remoto, API, identidad, permiso o dependencia de datos necesarios.
  5. Confirme los tipos de archivo, los tipos de script, el comportamiento del espacio aislado, el almacenamiento y los requisitos de confidencialidad admitidos.
  6. Pruebe los escenarios esperados, ambiguos, no admitidos y de error.
  7. Registre la versión de la aptitud, el propietario, las dependencias, las limitaciones conocidas y el proceso de soporte técnico.

Para conocer las aptitudes que se usan directamente en Copilot Chat, consulte Crear aptitudes para Copilot Chat. Para conocer las restricciones actuales de soporte y tiempo de ejecución en agentes declarativos, consulte Habilidades en agentes declarativos. Para obtener información sobre Copilot Cowork, consulte Límites de archivos complementarios. Aplique los requisitos de cada host de destino cuando distribuya una aptitud a más de una experiencia.

Confirme que la aptitud funciona

La aptitud está lista para la integración cuando:

  • El agente o la experiencia de destino pueden cargarla y usarla.
  • Sus instrucciones realizan el trabajo definido de forma coherente.
  • Los recursos, scripts, herramientas y datos necesarios están disponibles.
  • Los permisos y las dependencias externas funcionan en el entorno de desarrollo o prueba.
  • Las operaciones no admitidas o con errores producen un comportamiento comprensible.
  • Se registran la propiedad, el control de versiones, las limitaciones y las pruebas de prueba.

Continúe con cualquier otro componente del plan. Cuando estén completos, integra y prueba tus componentes, luego pasa a Paquete & prueba para crear el paquete de complementos.