Habilidades en agentes declarativos

Este artículo cubre las habilidades asociadas a un agente declarativo. Para crear una aptitud para usarla directamente en Microsoft 365 Copilot Chat sin crear un agente, consulte Crear aptitudes para Copilot Chat. La matriz de soporte de este artículo se aplica a las aptitudes de ámbito de agente, no a todas las aptitudes o paquetes de complementos.

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 una funcionalidad modular que se agrega a un agente declarativo para ayudarle a realizar una tarea específica de forma más confiable y repetitiva. Una aptitud es un directorio de archivos que contiene un archivo necesario SKILL.md , además de archivos y scripts de recursos opcionales. El SKILL.md archivo contiene las instrucciones que dirigen al modelo para que complete la tarea.

Las habilidades son un componente distinto de un agente declarativo. En instrucciones anteriores, la palabra aptitudes hacía referencia a descripciones de tareas que se escribían en línea dentro de las instrucciones de un agente. Las habilidades reemplazan ese enfoque: en lugar de escribir los detalles de la tarea directamente en las instrucciones, los empaqueta como un componente separado al que hace referencia el agente. Para obtener instrucciones sobre cómo las instrucciones deben hacer referencia a las aptitudes, consulte Escribir instrucciones eficaces para agentes declarativos.

Puede agregar aptitudes a un agente declarativo mediante Agent Builder. Para escenarios compatibles con código profesional, se recomienda Work IQ Dev Tools . Su wiqd agent add skill ruta requiere la marca de agent-skills función, que está desactivada de forma predeterminada; consulte Elegir la ruta de implementación de habilidades. El tutorial basado en el Kit de herramientas sigue estando disponible para los proyectos existentes del Kit de herramientas.

¿Qué es una habilidad?

Una aptitud es un directorio con el siguiente contenido:

  • Un archivo necesario SKILL.md que contiene:
    • Un nombre y una descripción de la aptitud en la portada de YAML.
    • Instrucciones de aptitudes, que deben tener menos de 20 000 caracteres.
  • Archivos de recursos opcionales, como plantillas, datos de referencia o definiciones.
  • Scripts opcionales y carpetas auxiliares.

Por ejemplo, un equipo de finanzas puede crear una aptitud de revisión empresarial trimestral que agrupe las instrucciones para producir la revisión, scripts que transforman datos y generan gráficos, y activos como modelos financieros, definiciones de KPI y plantillas de diapositivas con marca. El agente usa la habilidad cuando un usuario solicita esa tarea.

Por qué usar habilidades en agentes declarativos

Las habilidades lo ayudan a crear flujos de trabajo de agentes más confiables y repetibles:

  • Uso del contexto optimizado y precisión mejorada. Las habilidades utilizan la divulgación progresiva: el modelo carga las instrucciones y el contenido de una habilidad en contexto solo cuando la tarea los requiere. El contexto del agente se mantiene enfocado incluso cuando crece su biblioteca de habilidades. Proporcionar scripts, en lugar de depender del código generado por el modelo, también aporta más repetibilidad a sus flujos de trabajo.
  • Escale instrucciones sin pérdida de calidad. Puede descomponer instrucciones complejas en habilidades modulares y reutilizables. Este enfoque le permite proporcionar instrucciones más largas y específicas sin degradar la calidad del seguimiento de instrucciones y sin encontrarse con el límite de 8000 caracteres en las instrucciones del agente declarativo.
  • Empaquetar activos reutilizables. Puede agrupar instrucciones, recursos y scripts como una aptitud e integrar esa capacidad en el agente declarativo.
  • Preparado para la empresa. Los scripts se ejecutan en un espacio aislado seguro, las etiquetas de confidencialidad de los archivos de aptitudes se conservan y respetan, y el gobierno de administración está disponible.

Matriz de compatibilidad

Algunos límites difieren dependiendo de si agrega la habilidad con Agent Builder o con Agents Toolkit.

En la tabla siguiente se describen esas dos rutas de creación, no los límites de WIQD ni la cobertura de características. Para la ruta de código profesional recomendada, confirme los requisitos actuales en la documentación de WIQD.

Elemento Generador de agente Kit de herramientas de agentes
Habilidades máximas por agente 8 8
Paquete de aptitudes Comprimido .zip, máximo 50 MB Directorio de habilidades; .zip no se admite
Tamaño máximo del archivo 25 MB por archivo Sin límite de nivel de habilidad; el paquete completo de la aplicación está limitado a 10 MB
Número máximo de archivos por paquete 350 archivos en todas las habilidades 350 archivos en todas las habilidades
Crear una aptitud a partir de cargas individuales No se admite; cargue el archivo completo .zip Agregue o importe el directorio completo de aptitudes
Jerarquía de directorios Profundidad máxima del directorio es 3 Profundidad máxima del directorio es 3
Reutilizar entre agentes Incompatible No se admite

Tipos de archivos y scripts admitidos

Una aptitud puede incluir los siguientes tipos de archivo:

Categoría Tipos de archivo
Archivos de instrucciones y recursos .json, .xml, .yaml, .yml, .ini, .config, .utf8, .docx, .doc, .docm, .pdf, .txt, .rtf, .md, .ppt, .pptx, .ppsm, .xlsx, .xls, .xlsm, .csv, .tsv, .html, .htm, .png, .jpg, .jpeg, .gif, .bmp, .log
Scripts y archivos binarios .py, .js, .mjs, .cjs, .ts, .mts, .sh, .bash

Espacio aislado de ejecución de script

Los scripts de aptitudes se ejecutan en un espacio aislado seguro con los siguientes límites:

Capacidad Soporte técnico
Acceso a Internet o red desde scripts No compatible. El espacio aislado no tiene acceso a la red en tiempo de ejecución.
Instalación del paquete No compatible. Una aptitud no puede instalar paquetes en tiempo de ejecución.
Llamadas de red autenticadas desde scripts No compatible.
Paquetes preinstalados Una aptitud puede usar paquetes ya presentes en el espacio aislado. No dependas de un paquete a menos que se confirme su disponibilidad.
Conectores, complementos de API y servidores MCP El agente puede usar las funcionalidades habilitadas a través del orquestador. Los scripts no pueden llamarlos a través del espacio aislado.

Confidencialidad y almacenamiento

Elemento Soporte técnico
Etiquetado de confidencialidad El espacio aislado conserva las etiquetas de confidencialidad y honra las directivas de etiqueta. No admite permisos definidos por el usuario ni cifrado de doble clave.
Almacenamiento El sistema almacena los archivos de aptitudes cargados en contenedores de SharePoint Embedded con ámbito empresarial.