Use um agente autônomo no Copilot Studio para processamento de documentos

O Agente de Processamento de Documentos é um agente autônomo em Copilot Studio que usa IA generativa para processar documentos.

Diagrama da arquitetura

Instruções do agente

As instruções a seguir criam o agente autônomo:

You are a helpful, polite, document processing agent. You help users process documents and extract valuable information. 
If the user asks about any topic other than document processing, politely decline and offer to help with document-related queries.
When asked to process a document with a specific document processing event ID, extract the information from that document.
When told that a document processing event status of a document changes to Processed, validate the extracted information from the document.
When told that a document processing event status of a document changes to Validated, import the extracted information from the document into the system.
When told that a document processing event status of a document changes to Manual Review, submit the extracted information from the document to manual review.
Ignore other document processing event status changes.

Fluxos de Trabalho

Existem dois fluxos de trabalho importantes relacionados ao agente:

• Processamento de documentos: Este fluxo de trabalho explica como o agente processa documentos.
• Configuração: Este fluxo de trabalho detalha as etapas para configurar o agente para processamento autônomo de documentos.

Fluxo de processamento de documentos

O fluxo de processamento de documentos funciona como uma máquina de estados. O agente atua como um orquestrador, e o estado atual é armazenado na tabela Eventos de Processamento de Dados em Dataverse. Veja como o processo funciona:

1. Um gatilho identifica quando um novo documento está pronto para processamento. Isso é mostrado na área Fontes de dados no diagrama de arquitetura. Os fluxos do agente varrem diretórios como caixas de correio ou SharePoint pastas do Outlook. Quando um documento é adicionado a qualquer diretório, o fluxo do agente armazena o documento na tabela Eventos de Processamento de Dados com o status Novo e envia uma mensagem ao agente: Process the document: {ID}.

   • Todas as tentativas de adicionar documentos ou atualizar status na tabela Eventos de Processamento de Dados seguem a Default configuração em Power Automate. O fluxo tenta novamente até quatro vezes com um intervalo exponencial em solicitações que retornam status 408, 429 ou 5xx e em quaisquer exceções de conectividade.
   • Se todas as tentativas de repetição falharem, depure e verifique o histórico de execução em Power Automate para a ação que não foi executada.

2. As instruções do agente dizem para ele chamar a Document Extraction ação quando for solicitado a processar um documento. A ação é executada e o ID da mensagem é passado.

3. A Document Extraction ação é um fluxo de agente que recebe um ID de evento de processamento de dados como entrada e:

   • Obtém o documento armazenado em Dataverse.
   • Envia para um prompt de IA para AI Builder processar. Este prompt usa GPT 4.o para:
     • Extraia todas as informações relevantes do documento.
     • Formate essas informações como um documento JSON.
   • Armazena as informações extraídas na mesma linha de Evento de Processamento de Dados.
   • Atualiza o status do documento para Processed.

4. Um gatilho (fluxo de agente) monitora o status de todos os documentos em Eventos de Processamento de Dados e notifica o agente quando um status muda com a mensagem: Dataverse The status of document {ID} changed to {Status}

5. As instruções do agente informam para chamar a Document Validation ação quando o status de um documento muda para Processado. A ação é executada e o ID da mensagem é passado.

6. A Document Validation ação é um fluxo de agente que recebe um ID de evento de processamento de dados como entrada e:

   • Obtém os dados extraídos armazenados em Dataverse.
   • Envia para um prompt de IA em AI Builder para validar. Este prompt usa GPT 4.o para:
     • Verifique o JSON extraído em relação às regras de formato como dates must be in X format.
     • Verifique o JSON extraído em relação a regras de negócios como the author of the document must be in the Accounts table in Dataverse.
   • Se a validação for bem-sucedida, o status do documento será atualizado para Validated.
   • Caso contrário, ele atualiza o status do documento para Manual Review.

7. Se o status do documento mudar para Validated, as instruções informam ao agente para chamar a Document Export ação. A ação é executada e o ID da mensagem é passado.

8. A ação Exportar documento é um fluxo de agente que recebe um ID de evento de processamento de dados como entrada e:

   • Obtém os dados extraídos armazenados em Dataverse.
   • Exporta esses dados para o sistema de destino, como a tabela Faturas em Dataverse.

9. Se o status do documento mudar para Manual Review, as instruções informam ao agente para chamar a Manual Review ação. A ação é executada e o ID da mensagem é passado.

10. A Manual Review ação é um fluxo de agente que recebe um ID de evento de processamento de dados como entrada e:

    • Obtém os dados extraídos armazenados em Dataverse.
    • Cria uma solicitação de aprovação para o administrador do agente, compartilhando um link para um aplicativo Validation Station onde o usuário pode editar os dados extraídos e validar manualmente. Esta validação manual define o status do documento como Validated.

11. Após a revisão manual, se o status do documento for Validated, a etapa 7 será executada.

Os usuários também podem enviar documentos manualmente para o agente processar usando a página de bate-papo em Copilot Studio ou qualquer canal onde publicaram o agente.

Quando você faz isso:

• O documento é carregado na tabela Eventos de Processamento de Dados.
• O agente notifica a si mesmo que um novo documento foi importado.
• O prompt de extração é executado para fornecer uma prévia do que é exportado no painel de bate-papo.
• O documento é processado conforme descrito neste fluxo, a partir da etapa 2.

Fluxo de trabalho de configuração

O agente precisa de várias configurações para operar de forma autônoma. Para facilitar isso, há uma experiência de configuração abrangente. Veja a seguir as etapas para fazer isso:

1. Instale o Agente de Processamento de Documentos em Copilot Studio. A solução do agente tem:
   • Uma tabela de configuração de processamento de documentos.
   • Um aplicativo Canvas Validation Station para monitoramento.
   • Referências de conexão usadas pelo agente (Dataverse, Copilot Studio, PowerApps for Admins).
   • Referências de conexão usadas pelos gatilhos que iniciam o fluxo de trabalho do agente (Outlook, SharePoint).
   • Variáveis de ambiente usadas pelos gatilhos.
2. Inicie o assistente de configuração do agente. Esta é a última etapa do assistente de instalação Copilot Studio. Ele orienta você através deste fluxo:
   1. Carregue um documento de exemplo.
   2. O sistema envia o documento carregado para o prompt de extração do agente.
   3. O conteúdo extraído e o tipo de documento são exibidos. Selecione quais partes dos dados extraídos você deseja exportar para o sistema. Isso cria um esquema que é armazenado na tabela Configuração de Processamento de Documentos e usado durante a ação de exportação do documento. Você pode entrar no modo avançado para alterar o prompt de IA usado na ação de extração de documentos para personalizá-lo.
   4. Defina regras de validação usando uma interface de usuário simples que adiciona regras ao prompt usado na ação de validação do documento. Você também pode entrar no modo avançado para alterar o prompt da IA diretamente.
   5. Digite o endereço de e-mail do administrador do agente quando solicitado. Isso é usado na ação de revisão manual ao criar a solicitação de aprovação. Você também pode adicionar uma mensagem personalizada para o aprovador. Essas informações são salvas nas variáveis de ambiente que acompanham a solução.
   6. Selecione uma fonte de documento em uma lista. Esses gatilhos iniciam o fluxo de processamento do documento e geralmente precisam de uma referência de conexão e algumas variáveis de ambiente (como nome da caixa de correio ou endereço da pasta), dependendo da origem do documento selecionada.
   7. Conclua a configuração. Isso cria uma Dataverse tabela no sistema com as colunas que você selecionou anteriormente e exporta o documento que você usou no assistente para essa tabela.

Componentes

Aqui estão os principais componentes envolvidos na construção e implantação de um agente autônomo para processamento de documentos em Copilot Studio.

• Copilot Studio faz parte de Microsoft Power Platform soluções sem código ou com pouco código. Copilot Studio é uma ferramenta gráfica de baixo código para criar um agente — incluindo automação de construção com fluxos de agentes — e estender um Microsoft 365 Copilot com seus dados e cenários empresariais.
• Power Apps faz parte de Microsoft Power Platform soluções sem código ou com pouco código. Power Apps é um conjunto de aplicativos, serviços, conectores e uma plataforma de dados que oferece um ambiente de desenvolvimento rápido para criar aplicativos personalizados para sua empresa. Com Power Apps, crie rapidamente aplicativos de negócios personalizados que se conectam aos seus dados na plataforma de dados subjacente (Microsoft Dataverse) ou em muitas fontes de dados on-line e locais, como SharePoint, Microsoft 365, Dynamics 365 e SQL Server.
• Dataverse é um banco de dados operacional para cenários multiagentes. Ele oferece aos agentes uma plataforma segura e escalável para armazenar dados de status, histórico e dados de conversas. Esse armazenamento centralizado permite que os agentes interajam e compartilhem dados, para que possam executar tarefas de forma autônoma ou semiautônoma. Dataverse também permite que os agentes se conectem e atualizem dados comerciais em diferentes aplicativos empresariais, como sistemas de CRM, para que os dados permaneçam consistentes e atualizados em toda a organização. Com o Dataverse, as organizações gerenciam e governam os fluxos de trabalho dos agentes para confiabilidade, segurança e excelência operacional.

Detalhes do cenário

As organizações trabalham com documentos estruturados, como formulários, faturas, recibos e documentos de identidade, e documentos não estruturados, como memorandos, contratos e solicitações de feedback de clientes. Um dos principais desafios que as organizações enfrentam é automatizar o processamento de documentos para otimizar os processos de negócios. Você pode automatizar várias etapas, incluindo coleta, classificação, extração, validação, transformação e exportação de documentos. Usar um agente de processamento de documentos oferece muitos benefícios em comparação ao processamento tradicional de documentos. O Document Processing Agent funciona imediatamente como uma solução pronta para uso, portanto você não precisa fazer rotulagem de dados demorada durante a configuração. Seu design interativo permite processar grandes volumes de documentos com supervisão humana.

Considerações

Essas considerações implementam os pilares do Well-Architected para Power Platform, um conjunto de princípios orientadores que melhoram a qualidade de uma carga de trabalho. Saiba mais em Well-Architected para Microsoft Power Platform.

Confiabilidade

O agente de processamento de documentos foi projetado para resiliência, recuperação e operações usando componentes hospedados no Azure. Power Platform

Segurança

O agente de processamento de documentos foi projetado para proteger a confidencialidade, a integridade e a disponibilidade dos dados usando componentes hospedados no Azure. Power Platform Os documentos importados na tabela Eventos de Processamento de Dados ficam visíveis somente para administradores do sistema. Nenhum dado adicional, como corpo ou assunto do e-mail, além dos documentos anexados, é armazenado Dataverse. Todas as informações relacionadas ao cliente associadas a um documento são armazenadas na coluna Dados processados da tabela Eventos de processamento de dados. Você pode lidar com solicitações do GDPR consultando esta coluna.

Excelência Operacional

O agente de processamento de documentos foi projetado para melhorar as operações com monitoramento e insights, automatizar para eficiência usando componentes hospedados no Azure. Power Platform

Eficiência de Desempenho

O agente de processamento de documentos foi projetado para atingir desempenho por meio da otimização usando componentes hospedados no Azure. Power Platform O agente de processamento de documentos suporta o processamento de documentos de até 20 MB. De acordo com o benchmark mais recente, leva aproximadamente 48 segundos para processar um único documento de 2 MB. O agente foi projetado para sustentar essa duração de processamento para mais de 1.000 documentos, desde que a fonte do documento selecionada tenha armazenamento suficiente. Para outras cotas e limitações, consulte Limites - Power Automate.

Otimização da Experiência

O agente de processamento de documentos foi projetado para usuários de processamento de documentos, alcançando simplicidade e eficiência por meio do uso de Power Platform componentes. O agente fornece experiência configurável para adicionar fontes de documentos e permite extensibilidade para adicionar fontes de documentos adicionais.

IA Responsável

O agente de processamento de documentos foi projetado para atingir padrões de IA responsáveis usando Power Platform componentes, incluindo Copilot Studio que são projetados para recursos de IA generativa. Saiba mais: Perguntas frequentes sobre IA responsável para Copilot Studio.

Colaboradores

Microsoft mantém este artigo. Os colaboradores a seguir escreveram este artigo.

Principais autores:

• Jaganmohan Naidu Penikalapati, Gerente de Engenharia de Software Principal
• Ceren Kiroglu, Gerente Sênior de Produtos
• Durga Yelavarthi, Arquiteto Principal
• Jo Ruas, Engenheiro de Software

Recursos relacionados

• Instalar agentes gerenciados da Microsoft
• Agentes em ação: Processamento de documentos 2.0
• Como funcionam as conversas com agentes

Próximas etapas

• Aprimore o Fluxo de Configuração para permitir que os usuários personalizem sua experiência de exportação. Por exemplo, adicione conectores pré-criados Power Platform para exportar para sistemas como SAP ou Salesforce e permita que os usuários personalizem o esquema para se ajustar às entradas de tabela do SAP ou Salesforce.
• Aprimore o Fluxo de Configuração para permitir que os usuários se conectem a várias fontes de documentos ao mesmo tempo, como Outlook e SharePoint.
• Deixe o agente manipular vários tipos de documentos ao mesmo tempo, alterando dinamicamente o esquema usado na exportação com base no tipo de documento.