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.
Durante a Criação ou reutilização, implemente o componente declarative-agent selecionado no plano do componente. Este artigo ajuda você a escolher o procedimento do produto e confirmar a prontidão do componente. Você termina com um agente de trabalho, suas dependências e evidências de teste para integração de plug-in.
Você não precisa de um agente para cada plugin. Para sua própria orquestração, modelos, hospedagem ou tempo de execução, siga o caminho do aplicativo .
Verifique um agente existente antes de criar um
Revise os usuários pretendidos do agente existente, as experiências com suporte, as instruções, os conhecimentos, as ações, as permissões e as limitações conhecidas com seu proprietário.
Verificar: Seus recursos documentados correspondem à tarefa e à experiência de destino em seu plano de componente.
Selecione a rota de reutilização ou extensão documentada do produto. Você pode começar com um modelo de agente ou copiar um agente do Agent Builder para o Copilot Studio quando esse fluxo de trabalho se encaixar.
Verificar: O roteiro oferece suporte à origem e ao destino. Não presuma que adicionar um componente de agente a um plug-in importa um projeto existente.
Concordar sobre propriedade, controle de versão, suporte e gerenciamento de alterações e, em seguida, testar tarefas representativas.
Verificar: Registre os resultados e as lacunas não resolvidas antes de decidir usar o agente inalterado, configurá-lo ou criar um novo componente.
Comece com o Work IQ Ferramentas de Desenvolvimento
Para desenvolvimento profissional, comece com o Work IQ Dev Tools, escolha um ambiente documentado e adicione o Agents Toolkit somente quando seu componente precisar de seus controles de projeto específicos.
| Seu ponto de partida | Procedimento do produto | Resultado esperado |
|---|---|---|
| Um novo plug-in que precisa de um componente de agente | Criar um plug-in com as Ferramentas de Desenvolvimento do Work IQ |
wiqd plugin create cria o contêiner; wiqd plugin add agent Cria um scaffolds do componente opcional do agente. |
| Um projeto de origem de agente declarativo existente | Ciclo de vida do componente do agente | Continue a criação e a iteração específicas do agente com os comandos documentados wiqd agent . |
| Instruções, conhecimentos ou ações do agente que precisam ser editadas | Agentes declarativos no WIQD e a referência de comando | Fonte salva configurada para o componente e o ambiente selecionados. |
Use o plug-in do assistente de codificação WIQD para trabalho guiado ou a CLI direta para comandos repetíveis. Instale o plug-in coding-assistente e a CLI como pré-requisitos separados quando necessário. O GitHub Copilot ajuda a criar arquivos, instruções, configurações e testes; ele não substitui os requisitos de ferramenta de criação, tempo de execução ou componente.
Para um projeto de agente existente, selecione a validação offline explicitamente:
wiqd agent validate --mode source --env dev
Verificar: Leia as descobertas da fonte salva e corrija os erros relatados. Uma marca de origem aprovada não estabelece o comportamento de tempo de execução, a acessibilidade do ponto de extremidade, a correção da autenticação ou a aceitação do pacote final. O modo padrão package consome um ZIP existente, carrega-o para validação e pode exigir entrada.
Para adicionar uma habilidade a um projeto de agente WIQD existente, marque o sinalizador de recurso e os requisitos de agent-skills esquema atuais na referência de comando de habilidade do agente. Uma habilidade de plug-in de nível superior e uma habilidade anexada a um agente declarativo são registros diferentes; Nenhum dos dois estabelece suporte em todos os hosts.
Use outra rota de produto quando ela se ajustar ao componente
| Requisito | Procedimento do produto |
|---|---|
| Criação gerenciada no Microsoft 365 Copilot | Visão geral e agentes de Builddo Agent Builder |
| Lógica low-code, ambientes gerenciados ou conectores do Power Platform | Copilot Studio e Conecte e configure um agente para o Teams e o Microsoft Copilot |
| Manifestos de agentes de nível inferior e integrações de desenvolvimento com suporte | Ferramentas de desenvolvimento do Work IQ (recomendado para cenários de código profissional com suporte) |
| Habilidades em um agente do Toolkit existente | Adicionar habilidades com o Kit de Ferramentas de Agentes |
Os agentes autônomos do Copilot Studio aparecem no Registro de Agentes, não em plug-ins. Não presuma que a publicação de um agente autônomo o reempacota como um plug-in.
Configurar e testar o agente
Para obter etapas detalhadas de implementação, siga a orientação do produto de agente declarativo:
| Trabalho para concluir | Diretrizes autorizadas | Verificar |
|---|---|---|
| Defina identidade, comportamento, limites de tarefas e iniciadores de conversa | Crie agentes ou Compile com JSON e, em seguida, Escreva instruções efetivas | Os prompts representativos produzem o comportamento esperado e permanecem dentro da tarefa pretendida. |
| Configurar conhecimento e funcionalidades | Fontes de conhecimento e Adicionar funcionalidades e ações personalizadas | Os dados obrigatórios estão disponíveis para o usuário pretendido e indisponíveis quando as permissões não o permitem. |
| Adicionar ações de MCP ou API compatíveis | Plugins MCP e API para agentes declarativos | A seleção de ferramentas, autenticação, consentimento, confirmações, erros e solicitações sem suporte se comportam conforme o esperado. |
| Adicionar uma habilidade com suporte | Competências em agentes declarativos e o procedimento de autoria selecionado | O agente de destino carrega a habilidade e conclui a tarefa definida dentro dos limites do produto. |
| Gerenciar a configuração da sua rota de criação | Ambientes e versões de kits de ferramentas ou ambientes WIQD | Os valores de identidade, as dependências e as configurações pertencem ao ambiente de teste pretendido. |
Registre a versão do agente, o proprietário, as experiências com suporte, as dependências, as limitações conhecidas e os resultados do teste. São necessários testes específicos do produto; Passar na validação de origem ou pacote não é evidência de que todos os usuários podem executar a tarefa.
Para obter diretrizes de design, consulte Práticas recomendadas para agentes declarativos e Como o orquestrador do Copilot escolhe ações. Quando o comportamento necessário funciona, você pode, opcionalmente, ativar os comentários do usuário e otimizar a recuperação de conteúdo.
Próxima etapa
Continue os componentes restantes no Build ou reutilize. Quando estiverem prontos, insira Pacote & teste com Integrar e teste seus componentes.