Guia de leitura localizado
declarative-agent-developerFinalidade, utilização e fonte
Criar, construir, implantar e localizar agentes declarativos para M365Copilot e Teams. USE ESTA HABILIDADE para QUALQUER tarefa envolvendo um agente declarativo — incluindo localização, criação de scaffolding, edição de manifestos, adição de funcionalidades e implantação. A localização requer manifestos tokenizados e arquivos de idioma que somente esta habilidade sabe como gerar. Gatilhos: "criar agente", "criar um agente declarativo", "novo agente declarativo", "criar scaffolding de um agente", "novo projeto de agente", "adicionar uma funcionalidade", "adicionar um plugin", "configurar meu agente", "implantar meu agente", "corrigir o manifesto do meu agente", "editar meu agente", "localizar meu agente", "adicionar localização", "traduzir meu agente", "agente multilíngue", "adicionar um plugin de API", "adicionar um plugin MCP", "adicionar OAuth ao meu plugin", "revisar instruções", "melhorar instruções", "corrigir minhas instruções"
Fonte recuperada:
- Repositório de origem
- microsoft/skills
- SKILL.md
.github/plugins/microsoft-365-agents-toolkit/skills/declarative-agent-developer/SKILL.md- Estrelas do repositório
- 3,157
- Atualização do repositório
- 2026-10-31
- Classificação de Habilidades
- Fluxo de trabalho do agente
- Última coleta
Licença: MIT
Os trechos do fluxo de trabalho são auxiliares de leitura e não instruções executáveis do Codez. Nenhuma Skill de terceiros foi executada para gerar esta página.
Os trechos abaixo, que descrevem o propósito e o fluxo de trabalho, são material original, organizado e traduzido para facilitar a leitura. Eles são distintos da análise editorial da Codez, que possui uma etiqueta separada.
O que esta habilidade faz
Criar, construir, implantar e localizar agentes declarativos para M365Copilot e Teams. USE ESTA HABILIDADE para QUALQUER tarefa envolvendo um agente declarativo — incluindo localização, criação de scaffolding, edição de manifestos, adição de funcionalidades e implantação. A localização requer manifestos tokenizados e arquivos de idioma que somente esta habilidade sabe como gerar. Gatilhos: "criar agente", "criar um agente declarativo", "novo agente declarativo", "criar scaffolding de um agente", "novo projeto de agente", "adicionar uma funcionalidade", "adicionar um plugin", "configurar meu agente", "implantar meu agente", "corrigir o manifesto do meu agente", "editar meu agente", "localizar meu agente", "adicionar localização", "traduzir meu agente", "agente multilíngue", "adicionar um plugin de API", "adicionar um plugin MCP", "adicionar OAuth ao meu plugin", "revisar instruções", "melhorar instruções", "corrigir minhas instruções"
Como funciona o fluxo de trabalho upstream
⛔ Verificação do Espaço de Trabalho — PRIMEIRO PASSO OBRIGATÓRIO
Antes de fazer QUALQUER COISA, verifique os arquivos do espaço de trabalho para identificar o projeto: Executenpx -y --package @microsoft/m365agentstoolkit-cli atk --versionPara confirmar se o ATK CLI está instalado. Se não for encontrado → Pare. Peça ao usuário para instalar o ATK. Verifique sem365agents.ymlouteamsApp.ymlna raiz do projeto. Verifique seappPackage/declarativeAgent.json.
6Sempre atualize as instruções e os arquivos iniciais após qualquer alteração.
Adicionar uma funcionalidade ou plugin sem atualizar as instruções é incompleto. Após QUALQUER alteração: Atualize as instruções para descrever anew/changedFuncionalidade — cada fonte de dados deve ter uma cobertura de intenção clara (QUANDO e POR QUE usá-la) de acordo com a barra de qualidade da Revisão de Instruções. Os recursos integrados não precisam de nomes exatos;actions/pluginsdeve ser nomeado. NÃO liste nomes de ferramentas, descrições ou parâmetros nas instruções — estes já estão nos metadados do plugin (ai-plugin.json(Manifestos MCP, configuração de capacidade). As instruções devem conter apenas a lógica de decisão: QUANDO usar cada ferramenta, regras de encadeamento e tratamento de falhas. Adicione pelo menos1assunto para iniciar uma conversa, por exemplo.capability/plugin
export ATK_CLI_SKILL=trueRequisitos e configuração
Configuração da CLI do ATK
Antes de executar qualquer comando ATK, verifique se a CLI do ATK está disponível executando o seguinte comando:npx -y --package @microsoft/m365agentstoolkit-cli atk --versionSe não for encontrado, PARE e avise o usuário — NÃO tente instalar você mesmo. Todos os comandos usam onpx -y --package @microsoft/m365agentstoolkit-cli atkprefixo (ex.:npx -y --package @microsoft/m365agentstoolkit-cli atk provision --env local).
3Compatibilidade de versão do esquema
Antes de adicionar QUALQUER recurso, leia oversioncampo emdeclarativeAgent.jsone verifique a matriz de recursos do Schema. Se o recurso não for compatível com essa versão, recuse e ofereça uma atualização. Principais verificações de versão:
Limites e verificações de qualidade
2Nunca invente conteúdo nem crie arquivos ausentes.
NÃO invente nomes, descrições ou instruções provisórias. NÃO criedeclarativeAgent.jsonouappPackage/Se eles não existirem — este é um cenário de REJEIÇÃO, não um cenário de "ajuda através da criação".
4. Usarnpx -y --package @microsoft/m365agentstoolkit-cli atk add actionPara plugins de API — NUNCA crie arquivos de plugin manualmente
Você está proibido de criar manualmenteai-plugin.json, especificações OpenAPI, cartões adaptáveis ou edição doactionsarray. Use a CLI: Execute um úniconpx -y --package @microsoft/m365agentstoolkit-cli atk add actionchamada conforme a especificação OpenAPI, listando todas as operações como uma lista separada por vírgulas em--api-operationNunca execute separadamente.npx -y --package @microsoft/m365agentstoolkit-cli atk add actionsolicitações para diferentes operações da mesma especificação — isso cria vários plugins em vez de um. Senpx -y --package @microsoft/m365agentstoolkit-cli atk add actionSe falhar, reporte o erro; NÃO recorra à criação manual.
Comece com um teste seguro.
- Verifique o host compatível e as instruções de instalação do repositório. Mantenha o diretório Skill e seus scripts, recursos e documentação referenciados juntos;SKILL.mdsozinho pode omitir dependências.
- Forneça ao agente suas entradas reais, a saída desejada e os critérios de aceitação. A sintaxe de invocação e as ferramentas disponíveis dependem do host; este site não pressupõe um comando de instalação universal.
- Teste o fluxo de trabalho original em um projeto descartável ou em uma cópia. Analise as operações que alteram arquivos, serviços remotos ou recursos faturáveis antes de permiti-las.
- Valide o resultado comparando-o com as verificações de qualidade da fonte e com seus próprios requisitos. Um gatilho bem-sucedido ou uma alta contagem de estrelas no repositório não garantem um resultado correto.
Leia mais na fonte.
- Etiquetagem de telemetria
- ⛔ Verificação do Espaço de Trabalho — PRIMEIRO PASSO OBRIGATÓRIO
- 🚫 REGRAS RÍGIDAS DE REJEIÇÃO — Sem exceções
- 🔍 Detectar → Informar → Perguntar (Protocolo de Tratamento de Erros)
- Configuração da CLI do ATK
- 1Implantar após cada edição
- 2Nunca invente conteúdo nem crie arquivos ausentes.
- 3Compatibilidade de versão do esquema
- 4. Usar
npx -y --package @microsoft/m365agentstoolkit-cli atk add actionPara plugins de API — NUNCA crie arquivos de plugin manualmente - 5Integração do servidor MCP
- 6Sempre atualize as instruções e os arquivos iniciais após qualquer alteração.
- 7Requisito de nome do aplicativo
- Compartilhado
- Andaimes
- Desenvolvimento JSON
Habilidades relacionadas
Tradução e escopo
Este guia de leitura seleciona trechos do texto fixado a montante.SKILL.mdA tradução foi feita com auxílio de ferramentas. Este não é um manual completo nem garante compatibilidade comprovada. Leia o original e os arquivos referenciados antes de usar.
Esta introdução refere-se à versão fixada abaixo; a atividade atual do repositório e o tempo de coleta são mostrados separadamente.
- Fonte fixada
- Leia o original ↗
- Fonte recuperada
- Commit de origem
00d66a64919edca5bca2c673373444e36a4b5461- Fonte SHA-256
13d2af8dd44cca049c8ebf8a8880cca304fc3dc419c926ef146dba35b14df412