Criar um agente declarativo

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

  1. 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.

  2. 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.

  3. 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.