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.
Os agentes declarativos são executados na orquestração gerenciada e na infraestrutura de modelo de linguagem do Microsoft 365 Copilot. Você configura as instruções, as fontes de conhecimento e os recursos com suporte do agente, em vez de implementar e hospedar seu próprio runtime de conversação.
Um agente pode usar fontes de conhecimento do Microsoft 365, recursos internos, como interpretador de código, habilidades personalizadas (versão prévia) e ações fornecidas por servidores MCP ou APIs REST. Ele também pode delegar tarefas a agentes conectados. A disponibilidade depende da ferramenta de criação, da versão do manifesto, da experiência de destino, do licenciamento e das políticas organizacionais.
Use este artigo para entender o limite entre a plataforma gerenciada e os componentes que você configura ou opera. Para obter uma comparação com uma arquitetura que oferece controle sobre a orquestração e a hospedagem de modelo, consulte Comparar agentes de mecanismo declarativos e personalizados.
Componentes da arquitetura
O Microsoft 365 Copilot fornece o tempo de execução que interpreta as solicitações do usuário, recupera o contexto relevante, seleciona recursos e gera respostas. Sua configuração e serviços externos determinam o que o agente pode usar para concluir uma tarefa.
| Componente | Plataforma gerenciada | Responsabilidades do desenvolvedor |
|---|---|---|
| Cliente | Hospeda conversas em experiências compatíveis do Microsoft 365. | Escolha experiências-alvo e teste as interações com suporte, o contexto do documento e os formatos de resposta. |
| Infraestrutura | Hospeda a orquestração do Copilot e o tempo de execução do modelo. | Configure o agente e hospede quaisquer APIs externas, servidores MCP ou outros serviços que ele usa. |
| Catálogo e distribuição | Fornece experiências de aquisição, publicação e administração com suporte. | Selecione o pacote e a rota de distribuição com suporte, mantenha as versões e trabalhe com os administradores no acesso e na implantação. |
| Segurança e conformidade | Aplica as proteções de identidade, acesso a dados e plataforma do Microsoft 365. | Configure permissões e autenticação, avalie fluxos de dados e imponha autorização e proteção de dados em serviços externos. |
| Orchestrator e modelo de linguagem | Seleciona e invoca recursos e gera respostas. | Escreva instruções e descrições de ferramentas, defina as configurações de comportamento com suporte e avalie o comportamento resultante. Você não substitui o orquestrador gerenciado por código de tempo de execução personalizado. |
| Conhecimento e capacidades | Recupera o conhecimento suportado e executa recursos internos habilitados. | Selecione fontes e recursos relevantes, confirme o acesso do usuário e teste a qualidade da recuperação. |
| Chamada de ferramenta | Invoca ações MCP ou API configuradas por meio da integração com suporte. | Defina as entradas e saídas da ferramenta, configure a autenticação e as confirmações e implemente um comportamento de serviço confiável. |
As configurações com suporte influenciam o tempo de execução gerenciado; Eles não oferecem controle total sobre sua implementação. Por exemplo, o manifesto dá suporte a um modo de resposta padrão, que os usuários podem substituir. Siga o esquema de manifesto selecionado e a ferramenta de criação para obter as configurações disponíveis.
Observação
O conteúdo recuperado e as respostas da ferramenta podem conter instruções não confiáveis. As proteções da plataforma não substituem as verificações de autorização em seus serviços ou a avaliação do comportamento do agente. Planeje os requisitos de segurança, privacidade e dados aplicáveis.
Fluxo de dados do agente declarativo
O fluxo conceitual a seguir descreve como um agente usa sua configuração e recursos. Não é uma sequência de execução fixa ou uma garantia de quantas recuperações ou chamadas de ferramenta ocorrem.
- Receba uma solicitação. O usuário envia um prompt em uma experiência compatível. O histórico da conversa e o contexto de aplicativo disponível podem contribuir para a solicitação.
- Selecione o contexto e as funcionalidades relevantes. O Copilot usa as instruções, a configuração de conhecimento e as descrições da ferramenta do agente para determinar como lidar com a solicitação.
- Recupere informações ou invoque ações. O Copilot recupera o conhecimento disponível ou chama uma funcionalidade habilitada. As ações externas usam o comportamento de autenticação e confirmação configurado. Os serviços externos impõem suas próprias regras de autorização e de negócios.
- Gere uma resposta. O Copilot usa o contexto disponível e os resultados de funcionalidade para responder. Dependendo da tarefa, a interação pode incluir outras chamadas, solicitações de entrada do usuário ou delegação a um agente conectado.
Os agentes declarativos podem encadear chamadas de API, usar a saída de uma chamada como entrada de outra chamada e combinar conhecimento do SharePoint ou interpretador de código com ações de API. Para obter padrões e exemplos com suporte, consulte Encadeamento de chamadas de função em plug-ins de API.
As instruções orientam o comportamento do modelo; Eles não substituem a lógica do aplicativo que deve impor uma transação, uma ordem de execução exata ou um procedimento de recuperação. Implemente esses requisitos em uma API ou serviço de fluxo de trabalho ou avalie uma arquitetura de mecanismo personalizada quando precisar ser o proprietário da orquestração.
Design para limites específicos de funcionalidade
Verifique os limites nas diretrizes para cada funcionalidade e integração. O limite de caracteres de um campo de manifesto, um limite de configuração de fonte de conhecimento e um limite de contexto de runtime descrevem restrições diferentes.
| Área | Consideração de design | Orientação |
|---|---|---|
| Configuração do agente | Use propriedades e recursos compatíveis com a versão do esquema e a ferramenta de criação selecionadas. | Referência do manifesto do agente declarativo |
| Recuperação de conhecimento | Selecione fontes relevantes e siga os requisitos de arquivo, escopo, acesso e indexação específicos da fonte. Uma resposta não inclui necessariamente todos os itens em uma fonte. | Fontes de conhecimento e Otimizar a recuperação de conteúdo |
| Definições de ferramenta e cargas | Mantenha as ferramentas focadas e as entradas e saídas relevantes. Grandes entradas e saídas de plug-in podem ser truncadas e limites de contexto efetivos podem mudar com modelos e sobrecarga do sistema. | Limitações de MCP e plugin de API |
| Contexto do documento | Siga as interações de documento e os formatos de conteúdo com suporte do aplicativo host, em vez de presumir que todo o conteúdo do documento seja representado de forma idêntica. | Interagir com documentos |
| Comportamento e latência do serviço | Tempos de resposta de teste, falhas de autenticação, erros de serviço e os limites de suas APIs externas ou servidores MCP. | Integrar e testar componentes |
Para grandes conjuntos de dados, crie APIs para filtrar, agregar ou retornar o subconjunto relevante em vez de enviar todos os registros para uma conversa. Quando um cenário precisar de conteúdo de documento, teste a experiência de host com suporte: os agentes declarativos podem acessar todo o documento aberto no Word e no PowerPoint, sujeito às considerações de formato de documento.
Vantagens e limitações
As principais vantagens e limitações primárias dos agentes declarativos ajudam a determinar quando essa arquitetura é apropriada para casos de uso específicos.
Principais vantagens
Os agentes declarativos fornecem benefícios significativos para organizações que desejam implementar soluções de IA em ambientes existentes do Microsoft 365:
- Runtime de conversa gerenciado: a Microsoft hospeda o orquestrador e a infraestrutura de modelo, portanto, você não precisa implementar esse runtime.
- Acesso a recursos da Microsoft: Os agentes podem usar fontes de conhecimento compatíveis e recursos internos juntamente com ferramentas externas.
- Personalização baseada em configuração: instruções, recursos e ações personalizam a experiência sem exigir um mecanismo de conversação personalizado. As integrações externas ainda podem exigir código e hospedagem.
Limitações principais
A abordagem declarativa também introduz restrições que podem limitar certos casos de uso:
- Orquestração gerenciada: você influencia o comportamento por meio da configuração com suporte, em vez de controlar todas as decisões de tempo de execução. Avalie tarefas representativas em vez de tratar as instruções como um mecanismo de fluxo de trabalho determinístico.
- Dependências de plataforma e host: recursos, apresentação de resposta, licenciamento e administração dependem da experiência selecionada do Microsoft 365. Confirme o suporte em cada host de destino.
- Restrições de contexto e recuperação: Os resultados da recuperação de conhecimento e da ferramenta devem se ajustar ao contexto disponível. Grandes fontes ou conteúdos não garantem a cobertura completa em uma resposta.
- Considerações sobre conteúdo dinâmico da Web: a pesquisa na Web com escopo usa conteúdo indexado pelo Bing em vez de consultar diretamente a fonte de dados subjacente. O conteúdo gerado dinamicamente pode estar incompleto ou obsoleto. Use uma integração de API com suporte quando a tarefa exigir acesso direto a dados estruturados atuais. Consulte Base de pesquisa na Web e conteúdo dinâmico.
- Avaliação contínua: as atualizações de plataforma e modelo podem mudar o comportamento. Instruções de teste, recuperação e uso de ferramentas à medida que o agente e suas dependências evoluem.
Alinhamento de caso de uso
Escolha a arquitetura com base no controle que sua solução exige, não simplesmente no fato de a tarefa ter várias etapas.
Cenários ideais
Os agentes declarativos são ideais para:
- Recuperação de informações: agentes que precisam principalmente pesquisar e resumir informações do Microsoft 365 ou de fontes externas.
- Ações assistidas: agentes que combinam conhecimento e ações de API ou MCP com suporte para ajudar os usuários a concluir uma tarefa.
- Assistência e análise de documentos: agentes que trabalham com contexto de documento compatível ou usam recursos como interpretador de código.
- Melhoria da produtividade: tarefas que se beneficiam de uma experiência de conversação gerenciada no Microsoft 365.
Cenários inadequados
Considere um agente de mecanismo personalizado ou um fluxo de trabalho implementado separadamente quando seus requisitos incluirem:
- Controle de runtime personalizado: você deve implementar sua própria orquestração, hospedagem de modelo ou interface do usuário em vez de usar o runtime gerenciado do Copilot.
- Processos de negócios duráveis: o sistema deve impor a ordem de execução exata, os limites de transação, as tentativas ou a recuperação independentemente de uma conversa.
- Processamento de dados em larga escala: A tarefa requer o processamento exaustivo de um conjunto de dados, em vez de recuperação ou análise do contexto de conversação relevante. Execute esse processamento em um serviço e exponha o resultado apropriado ao agente.
- Acesso direto a fontes dinâmicas: a tarefa requer resultados atuais e ordenados de uma fonte que não está adequadamente representada na pesquisa na Web. Forneça uma integração de API ou MCP com suporte em vez de depender apenas da pesquisa na Web com escopo.
Esses requisitos nem sempre excluem um agente declarativo como a interface de conversa. Um serviço pode ser proprietário do processo de negócios enquanto o agente coleta entradas, invoca uma ação suportada e apresenta o resultado.