Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Las aptitudes de Microsoft 365 Copilot Chat están disponibles de forma general. Una aptitud empaqueta instrucciones específicas de la tarea, criterios de calidad y archivos o scripts opcionales para que los usuarios no tengan que repetir el mismo flujo de trabajo en cada conversación.
Puede crear una aptitud para usarla directamente en Copilot Chat sin crear un agente declarativo. Los usuarios pueden seleccionar explícitamente una aptitud instalada o dejar que Copilot la seleccione automáticamente cuando sea pertinente. Los usuarios controlan la invocación automática para cada habilidad.
Importante
En los inquilinos que usan barreras de información (IB) de Microsoft Purview, las aptitudes no se admiten en Copilot Chat. Esta restricción se aplica a las habilidades personales y a las distribuidas como parte de un complemento.
Elegir el ámbito de la aptitud
| Destino | Ruta de acceso de creación y distribución |
|---|---|
| Una aptitud personal usada directamente en Copilot Chat | Cree un archivo independiente SKILL.md o un archivo ZIP de aptitudes. Los usuarios también pueden crear y editar aptitudes personales con Copilot Chat. |
| Una aptitud distribuida como parte de un complemento | Use las herramientas de desarrollo de Work IQ para crear un paquete de aplicaciones de Microsoft 365 y, después, use un método de publicación o uso compartido compatible. |
Crear una aptitud personal
Recomendación
Si tiene previsto empaquetar su aptitud como un complemento, siga los pasos descritos en Empaquetar una aptitud en un complemento en su lugar. Las herramientas de desarrollo de Work IQ automatizan la mayoría de los pasos de esta sección.
Cada habilidad requiere un archivo llamado SKILL.md. Agregue scripts y recursos opcionales solo cuando la tarea los necesite.
release-notes/
|-- SKILL.md
|-- references/
| `-- release-note-format.md
`-- scripts/
`-- format_release_notes.py
Comienza SKILL.md con la portada YAML que contiene un nombre y una descripción. Para las habilidades del complemento WIQD, el nombre debe coincidir exactamente con la carpeta contenedora. Use de 1 a 64 caracteres alfanuméricos en minúsculas y guiones, sin guiones iniciales, finales o consecutivos. La descripción puede contener entre 1 y 1 024 caracteres y debe identificar las solicitudes que activan la habilidad.
Por ejemplo:
---
name: release-notes
description: Draft release notes or a changelog from a supplied list of changes, grouped into Features, Fixes, and Other.
---
# Release notes
Use this skill when the user asks for release notes or a changelog.
1. Use the change list supplied by the user. If it is missing, ask for it.
2. Group the changes into Features, Fixes, and Other.
3. Use references/release-note-format.md for the output structure.
4. Preserve issue and pull request links from the supplied input.
5. Don't invent changes, links, version numbers, or release dates.
6. Return the draft and identify any missing information.
Incluya cada archivo como referencia de instrucciones. Por ejemplo, si agrega un script de formato, explique cuándo ejecutarlo, qué entradas acepta y cómo controlar los errores. Mantenga las credenciales, los tokens y los secretos fuera de la aptitud.
Directrices de diseño
Mantener la aptitud enfocada
- Asigne a la aptitud un trabajo definido, con entradas, salidas y límites claros.
- Incluya frases en la descripción que es probable que los usuarios usen para ese trabajo.
- Mantenga
SKILL.mdmenos de 20 000 caracteres como recomendación de autor. Mueva el material de referencia detallado a los archivos auxiliares y explique cuándo leerlos. - Mantenga el directorio poco profundo e incluya solo los archivos necesarios para la tarea. Confirme el recuento de archivos, la profundidad del directorio y los límites de tamaño de paquete para cada host de destino.
Agregar scripts y recursos admitidos
Utilice tipos de archivo compatibles con el tiempo de ejecución de la aptitud de Chat:
| Categoría | Tipos de archivo |
|---|---|
| Archivos de instrucciones y recursos |
.json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .txt, .rtf, .md, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log |
| Scripts |
.py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash |
Las aptitudes de chat y las aptitudes asociadas a un agente tienen rutas de carga independientes. No aplique los límites de Agent Builder y Agents Toolkit a una carga de habilidad de chat personal.
Respetar el límite de tiempo de ejecución del script
Guiones de aptitudes:
- No se puede acceder a Internet o a la red en tiempo de ejecución.
- No se pueden instalar paquetes en tiempo de ejecución.
- Solo puede usar paquetes que ya están disponibles en el tiempo de ejecución.
- No puede realizar llamadas de red autenticadas.
Cuando una tarea requiera datos externos o acciones, haga que Copilot invoque un conector habilitado u otra funcionalidad externa compatible. No pongas llamadas de red en un script de habilidades como sustituto.
Para un complemento que incluya un conector MCP remoto, use la configuración del manifiesto de agentConnectors la aplicación. En las instrucciones de aptitud, explique cuándo y por qué Copilot debe usar el conector. La configuración de la conexión y los permisos de usuario permanecen separados de las instrucciones de aptitudes.
Cuenta para la protección de datos
Los archivos de aptitudes de chat cargados se almacenan en contenedores de SharePoint Embedded con ámbito empresarial. Las etiquetas de confidencialidad se conservan y se respetan las directivas de etiqueta. No se admiten los permisos definidos por el usuario ni el cifrado de doble clave.
Revise las instrucciones, los recursos, los scripts, el acceso a datos y los resultados en relación con los requisitos de su organización. Use los datos, la privacidad y la seguridad del plan para obtener una solución más amplia.
Cargar la aptitud
Para una carga directa de habilidades, proporcione SKILL.md solo o un archivo ZIP en SKILL.md su raíz y cualquier archivo compatible debajo. No incluya un directorio envolvente adicional arriba SKILL.md en el código postal.
En Copilot Chat, seleccione Agentes>Más agentes. Seleccione el menú desplegable junto a Agregar y seleccione Cargar habilidad.
Agrega tu archivo SKILL.md o ZIP y selecciona Cargar.
Empaquetar una aptitud en un complemento
Work IQ Dev Tools proporciona un flujo de trabajo pro-code para crear, validar, aprovisionar, empaquetar y compartir un complemento basado en habilidades.
Siga los requisitos previos de instalación y autenticación de WIQD en Crear un complemento.
Cree un proyecto de complemento y agregue una aptitud:
wiqd plugin create --name release-notes-plugin Set-Location release-notes-plugin wiqd plugin add skill --name "Release Notes"Edite lo generado y agregue los recursos o scripts a
appPackage/skills/release-notes/SKILL.mdlos que se hace referencia, siguiendo las instrucciones de Directrices de diseño.Siga el flujo de trabajo de WIQD para aprovisionar el entorno previsto, empaquetar el complemento y validar el archivo zip compilado real. La validación de la fuente por sí sola no inspecciona el contenido de las aptitudes ni prueba el comportamiento en tiempo de ejecución.
Publique o comparta el complemento y póngalo a disposición de los usuarios previstos.
Nota
El manifiesto de la aplicación Microsoft 365 registra aptitudes de nivel de complemento a través de agentSkills. Un agente declarativo hace referencia a sus habilidades de ámbito de agente a través agent_skills del manifiesto del agente declarativo. No intercambie estas propiedades ni asuma que al declarar una aptitud en una superficie, se registra en la otra.
Para conocer las reglas de formato, los detalles de los manifiestos y las restricciones específicas del host, consulte la referencia de creación de complementos de WIQD. Una habilidad destinada tanto a Chat como a Cowork debe cumplir los requisitos de ambos hosts.
Invocación y detección de pruebas
Pruebe la aptitud instalada en cada experiencia de Microsoft 365 que tenga previsto admitir:
- Confirme que un usuario previsto puede encontrar y seleccionar la aptitud.
- Seleccione explícitamente la aptitud, proporcione una entrada representativa y compruebe su salida y los archivos auxiliares.
- Habilite la invocación automática y use una solicitud que coincida con la descripción de la habilidad. Confirme que Copilot selecciona la aptitud prevista.
- Desactive la invocación automática y confirme que la habilidad no se selecciona automáticamente. La selección explícita es un caso de uso independiente.
- Compruebe las entradas faltantes, las solicitudes ambiguas, las herramientas no disponibles y los errores de script. Asegúrese de que la respuesta identifique el problema en lugar de devolver silenciosamente un resultado incompleto.
- Si el complemento incluye otras funcionalidades, pruébelas juntas. Confirme que el conector o la herramienta MCP previstos se invocan realmente.
- Si admite Chat y Cowork, compruebe la detección, instalación y ejecución en ambos. No inferir la disponibilidad o el soporte de edición en un producto a partir de una prueba correcta en el otro.
La publicación, la implementación, el uso compartido y la instalación son pasos distintos. Compruebe la experiencia instalada para el público previsto, en lugar de tratar una carga de paquete correcta como una prueba de que la aptitud se puede detectar.