Guía de lectura localizada
declarative-agent-developerFinalidad, uso y origen
Cree, construya, implemente y localice agentes declarativos para M365Copilot y Teams. UTILIZA ESTA HABILIDAD para CUALQUIER tarea que involucre un agente declarativo, incluyendo localización, andamiaje, edición de manifiestos, adición de capacidades e implementación. La localización requiere manifiestos tokenizados y archivos de idioma que solo esta habilidad sabe cómo producir. Activadores: "crear agente", "crear un agente declarativo", "nuevo agente declarativo", "andamiaje de un agente", "nuevo proyecto de agente", "agregar una capacidad", "agregar un complemento", "configurar mi agente", "implementar mi agente", "corregir el manifiesto de mi agente", "editar mi agente", "localizar mi agente", "agregar localización", "traducir mi agente", "agente multilingüe", "agregar un complemento de API", "agregar un complemento de MCP", "agregar OAuth a mi complemento", "revisar instrucciones", "mejorar instrucciones", "corregir mis instrucciones"
Fuente recuperada:
- Repositorio de origen
- microsoft/skills
- SKILL.md
.github/plugins/microsoft-365-agents-toolkit/skills/declarative-agent-developer/SKILL.md- Estrellas del repositorio
- 3,157
- Actualización del repositorio
- 2026-10-31
- Clasificación de habilidades
- Flujo de trabajo del agente
- Última recopilación
Licencia: MIT
Los extractos del flujo de trabajo son guías de lectura, no instrucciones ejecutables de Codez. No se utilizó ninguna habilidad de terceros para generar esta página.
Los siguientes fragmentos sobre el propósito y el flujo de trabajo son material preliminar, organizado y traducido para su lectura. Son distintos del análisis editorial de Codez, que se presenta por separado.
Lo que hace esta habilidad
Cree, construya, implemente y localice agentes declarativos para M365Copilot y Teams. UTILIZA ESTA HABILIDAD para CUALQUIER tarea que involucre un agente declarativo, incluyendo localización, andamiaje, edición de manifiestos, adición de capacidades e implementación. La localización requiere manifiestos tokenizados y archivos de idioma que solo esta habilidad sabe cómo producir. Activadores: "crear agente", "crear un agente declarativo", "nuevo agente declarativo", "andamiaje de un agente", "nuevo proyecto de agente", "agregar una capacidad", "agregar un complemento", "configurar mi agente", "implementar mi agente", "corregir el manifiesto de mi agente", "editar mi agente", "localizar mi agente", "agregar localización", "traducir mi agente", "agente multilingüe", "agregar un complemento de API", "agregar un complemento de MCP", "agregar OAuth a mi complemento", "revisar instrucciones", "mejorar instrucciones", "corregir mis instrucciones"
Cómo funciona el flujo de trabajo ascendente
⛔ Revisión del espacio de trabajo: PRIMER PASO OBLIGATORIO
Antes de hacer NADA, compruebe los archivos del espacio de trabajo para identificar el proyecto: Ejecutarnpx -y --package @microsoft/m365agentstoolkit-cli atk --versionpara confirmar que ATK CLI está instalado. Si no se encuentra → Detener. Dígale al usuario que instale ATK. Comprobar sim365agents.ymloteamsApp.ymlen la raíz del proyecto. Compruebe siappPackage/declarativeAgent.json.
6Actualice siempre las instrucciones y los iniciadores después de realizar cambios.
Agregar una capacidad o complemento sin actualizar las instrucciones es incompleto. Después de CUALQUIER cambio: Actualice las instrucciones para describir elnew/changedfuncionalidad: cada fuente de datos debe tener una cobertura de intención clara (CUÁNDO y POR QUÉ usarla) según la barra de calidad de Revisión de instrucciones. Las capacidades integradas no necesitan nombres exactos;actions/pluginsDeben tener nombre. NO enumere los nombres, descripciones o parámetros de las herramientas en las instrucciones; estos ya están en los metadatos del complemento (ai-plugin.json, manifiestos MCP, configuración de capacidad). Las instrucciones deben contener solo lógica de decisión: CUÁNDO usar cada herramienta, reglas de encadenamiento y manejo de fallas. Agregue al menos1Iniciador de conversación por añadidocapability/plugin
export ATK_CLI_SKILL=trueRequisitos y configuración
Configuración de ATK CLI
Antes de ejecutar cualquier comando de ATK, compruebe si la CLI de ATK está disponible ejecutandonpx -y --package @microsoft/m365agentstoolkit-cli atk --version. Si no se encuentra, DETÉNGASE e informe al usuario; NO intente instalarlo usted mismo. Todos los comandos utilizan elnpx -y --package @microsoft/m365agentstoolkit-cli atkprefijo (por ejemplo,npx -y --package @microsoft/m365agentstoolkit-cli atk provision --env local).
3Compatibilidad de versiones de esquema
Antes de agregar CUALQUIER función, lea elversioncampo endeclarativeAgent.jsony compruebe la matriz de características del esquema. Si la característica no es compatible con esa versión, rechácela y ofrezca actualizar. Puntos clave de control de versiones:
Límites y controles de calidad
2Nunca inventes contenido ni crees archivos faltantes.
NO invente nombres, descripciones o instrucciones de marcador de posición. NO creedeclarativeAgent.jsonoappPackage/Si no existen, se trata de un escenario de RECHAZO, no de un escenario de "ayuda mediante la creación".
4. Usarnpx -y --package @microsoft/m365agentstoolkit-cli atk add actionPara complementos de API: NUNCA cree archivos de complemento manualmente.
Tienes prohibido crear manualmenteai-plugin.json, especificaciones OpenAPI, tarjetas adaptativas o edición de laactionsmatriz. Utilice la CLI: Ejecute una solanpx -y --package @microsoft/m365agentstoolkit-cli atk add actionllamada según la especificación OpenAPI, enumerando todas las operaciones como una lista separada por comas en--api-operationNunca se ejecute por separadonpx -y --package @microsoft/m365agentstoolkit-cli atk add actionrequiere diferentes operaciones de la misma especificación; esto crea múltiples complementos en lugar de uno. Sinpx -y --package @microsoft/m365agentstoolkit-cli atk add actionSi falla, informe del error; NO recurra a la creación manual.
Comience con una prueba segura.
- Verifique el host compatible y las instrucciones de instalación del repositorio. Mantenga juntos el directorio Skill y sus scripts, recursos y documentación a los que hace referencia;SKILL.mdsolo puede omitir dependencias.
- Proporcione al agente sus datos reales, el resultado deseado y los criterios de aceptación. La sintaxis de invocación y las herramientas disponibles dependen del sistema anfitrión; este sitio no presupone un comando de instalación universal.
- Pruebe el flujo de trabajo original en un proyecto desechable o en una copia. Revise las operaciones que modifican archivos, servicios remotos o recursos facturables antes de autorizarlas.
- Valide el resultado comparándolo con los controles de calidad de origen y sus propios requisitos. Un activador exitoso o un alto número de estrellas en el repositorio no garantizan un resultado correcto.
Lea más en la fuente
- Etiquetado de telemetría
- ⛔ Revisión del espacio de trabajo: PRIMER PASO OBLIGATORIO
- 🚫 POLÍTICA DE RECHAZO INDIVIDUAL: Sin excepciones
- 🔍 Detectar → Informar → Preguntar (Protocolo de manejo de errores)
- Configuración de ATK CLI
- 1Implementar después de CADA edición
- 2Nunca inventes contenido ni crees archivos faltantes.
- 3Compatibilidad de versiones de esquema
- 4. Usar
npx -y --package @microsoft/m365agentstoolkit-cli atk add actionPara complementos de API: NUNCA cree archivos de complemento manualmente. - 5Integración del servidor MCP
- 6Actualice siempre las instrucciones y los iniciadores después de realizar cambios.
- 7Requisito del nombre de la aplicación
- Compartido
- Andamio
- Desarrollo JSON
Habilidades relacionadas
Traducción y alcance
Esta guía de lectura selecciona pasajes de la sección fijada en la parte superior.SKILL.mdLa traducción es asistida. No se trata de un manual completo ni garantiza la compatibilidad. Lea el original y los archivos a los que hace referencia antes de usarlo.
Esta introducción hace referencia a la versión fijada a continuación; la actividad actual del repositorio y la hora de recopilación se muestran por separado.
- Fuente fijada
- Lee el original ↗
- Fuente recuperada
- Confirmación de origen
00d66a64919edca5bca2c673373444e36a4b5461- Fuente SHA-256
13d2af8dd44cca049c8ebf8a8880cca304fc3dc419c926ef146dba35b14df412