Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Dica
Recomendado: Comece com o Work IQ Dev Tools para cenários de plug-in e de agente declarativo de código profissional com suporte. Consulte o início rápido do WIQD. As instruções baseadas em kit de ferramentas permanecem disponíveis para projetos e fluxos de trabalho existentes que as exigem. Verifique a capacidade e o suporte à experiência de destino antes de escolher uma ferramenta: O WIQD não tem como alvo agentes de mecanismo personalizados.
Importante
Em locatários que usam IBs (Barreiras de Informações do Microsoft Purview), os administradores podem implantar agentes declarativos com habilidades, mas os usuários finais não podem adicionar habilidades aos agentes declarativos criados por eles.
Uma habilidade é um componente modular que você adiciona a um agente declarativo para empacotar instruções, recursos e scripts para uma tarefa específica. Durante o Build ou reutilização, use este artigo quando o projeto escolhido já usar o Microsoft 365 Agents Toolkit (ATK). Você termina com uma habilidade registrada no agente, instruções de tarefas salvas e uma versão de teste provisionada.
Para um novo projeto de plug-in de desenvolvedor profissional, comece com o Work IQ Dev Tools e um ambiente documentado. Mantenha este procedimento do Kit de Ferramentas quando seus controles de projeto se ajustarem à rota de agente selecionada; Não é um requisito para todos os plugins.
Para saber quais são habilidades, por que usá-las e a matriz de suporte completa, tipos de arquivo com suporte, comportamento de área restrita e governança, consulte Habilidades em agentes declarativos.
Este guia adiciona habilidades no escopo do agente. Para distribuir uma habilidade para uso direto no Copilot Chat por meio de um plug-in, consulte Criar habilidades para o Copilot Chat.
Importante
Este guia pressupõe que você concluiu o tutorial Criar agentes declarativos usando o Microsoft 365 Agents Toolkit e JSON . Adicionar uma habilidade requer o manifesto de agente declarativo versão 1.9. Se você estiver usando um agente criado com uma versão mais antiga do Agents Toolkit, talvez seja necessário atualizar a versão do manifesto do agente. Para obter mais informações, consulte Referência do manifesto do agente declarativo.
Pré-requisitos
- CLI do Kit de Ferramentas de Agentes do Microsoft 365 ou extensão do Visual Studio Code do Kit de Ferramentas de Agentes do Microsoft 365
Habilitar habilidades do agente
O suporte a habilidades do TEAMSFX_AGENT_SKILLS agente é controlado pela variável de ambiente. Defina-o antes de iniciar a CLI ou o Visual Studio Code.
Windows (PowerShell) – para persistir a variável entre sessões, adicione-a às variáveis de ambiente do usuário:
[System.Environment]::SetEnvironmentVariable("TEAMSFX_AGENT_SKILLS", "true", "User")macOS ou Linux - Defina a variável:
export TEAMSFX_AGENT_SKILLS=truePara persistir a variável, adicione a
exportlinha ao seu~/.bashrcperfil shell ,~/.zshrc, ou equivalente.
Se você definir a variável depois de instalar a extensão do Visual Studio Code, reinicie o Visual Studio Code completamente.
Verificar: O processo de ferramenta reiniciado é TEAMSFX_AGENT_SKILLS definido como true. Uma configuração do Windows no nível do usuário não altera um processo que já estava em execução.
Adicionar uma habilidade ao seu agente
Em seu projeto existente, adicione uma habilidade. Para criar uma nova habilidade, forneça um nome e uma descrição:
atk add skill --name skill-name --description descriptionPara adicionar uma pasta de habilidades existente, use a
--fromopção:atk add skill --from PATH_TO_SKILLVerificar: O projeto contém o diretório de habilidades e
SKILL.md, e o manifesto declarativo-agent faz referência a essa habilidade. Siga a matriz de suporte; Essa opção de importação não estabelece a reutilização entre agentes.Edite
SKILL.mdas habilidades com as instruções da tarefa, os recursos e os scripts com suporte.Verificar: O arquivo salvo mantém seus metadados necessários e descreve a tarefa, a saída esperada e os limites.
Provisione o agente declarativo para disponibilizá-lo em seu ambiente:
atk provision --env localVerificar: O provisionamento foi bem-sucedido para o locatário e o ambiente pretendidos. Teste a tarefa da habilidade no agente pretendido; O sucesso do provisionamento não estabelece o comportamento do tempo de execução.
Limites
No Kit de Ferramentas de Agentes, você adiciona uma habilidade como um diretório (não é possível usar .zip), e o pacote completo do aplicativo é limitado a 10 MB. Você pode adicionar até oito habilidades por agente, com uma profundidade máxima de diretório de três e até 350 arquivos em todas as habilidades. Para obter a matriz de suporte completa, consulte Habilidades em agentes declarativos.
Publicar seu agente
Os ISVs (fornecedores independentes de software) podem enviar agentes declarativos que incluem habilidades para o Microsoft Marketplace. Use as Ferramentas de Desenvolvimento do Work IQ para validar e criar o pacote submittable a partir de um projeto de agente declarativo existente. Para pacotes de plug-ins, wiqd publish pc é possível criar a oferta do Partner Center, preencher a listagem de rascunho, carregar o pacote e as imagens, enviar para certificação com autorização separada e acompanhar o status. O registro e a verificação de conta do Partner Center continuam sendo etapas do portal e a Microsoft controla a certificação e a publicação.
Siga Publicar no Partner Center com WIQD para obter pré-requisitos, validação de pacote, configuração de listagem, envio e acompanhamento de status. O envio do portal continua sendo uma alternativa; confira o guia de envio do Microsoft Marketplace. Siga a rota de envio do agente confirmada, não um exemplo de Suplemento do Office ou um tipo de oferta presumido para plug-ins compostos.
Próxima etapa
Insira o pacote & teste com Integrar e teste seus componentes. Quando o agente estiver pronto para distribuição pública, continue a publicar por meio do Microsoft Marketplace.