Adicionar um nó de extração a um fluxo de trabalho

Note

As funcionalidades deste artigo são utilizadas por agentes ou fluxos de trabalho suportados pela estrutura do GitHub Copilot.

A faturação baseada no uso aplica-se à utilização, construção, teste e avaliação de agentes. Estas ações podem consumir Créditos Copilot. Saiba mais em Gerir custos para agentes alimentados pelo harness GitHub Copilot.

O nó de extração processa documentos e devolve os valores e tabelas que define. Suporta muitos tipos de documentos, incluindo faturas, contratos, relatórios, recibos, extratos bancários e demonstrações financeiras, em formatos de ficheiro como PDF, Word, Excel e PowerPoint. A informação extraída torna-se conteúdo dinâmico que passos posteriores do fluxo de trabalho podem utilizar.

O nó de extração proporciona uma experiência de autoria focada em documentos, com configuração fácil, testes em linha e ferramentas adaptadas à IA. Pode definir um esquema de extração a partir de um documento de exemplo, um modelo ou campos que adiciona manualmente.

Use o nó de extração quando um fluxo de trabalho precisa de transformar documentos numa estrutura previsível antes de criar um registo, enviar uma mensagem, tomar uma decisão ou chamar outra ação.

Captura de ecrã de um painel de configuração do nó Extract com opções para sugerir campos a partir de um documento de exemplo, selecionar um modelo ou adicionar campos manualmente.

Ao usar o nó de extração, pode:

  • Extrair valores nomeados e tabelas dos documentos.
  • Crie campos a partir de um documento de exemplo representativo.
  • Comece com um modelo para um tipo de documento comum.
  • Teste um nó de extração com um documento de teste carregado.
  • Pré-visualize o documento dentro do nó.

Adicionar um nó de extração

  1. No Copilot Studio, vai a Flows e abre um fluxo de trabalho existente, ou cria um novo.

    • Novo fluxo de trabalho: é direcionado para o estruturador para configurar um acionador.
    • Fluxo de trabalho existente: Abra o fluxo de trabalho e vá ao separador Build .

  2. Selecione o ícone Extrair no painel de Adicionar.

  3. Abre-se o painel de configuração do nó de extração.

Forneça a entrada para extrair

No campo do documento , introduza o documento que pretende processar. Utilize o seletor de conteúdo dinâmico para selecionar um ficheiro ou o conteúdo do ficheiro de um acionador, ação ou nó de fluxo de trabalho anterior.

Por exemplo, num fluxo de trabalho que é ativado quando um email chega com um anexo, defina a entrada para o conteúdo do ficheiro anexado. Num fluxo de trabalho desencadeado manualmente, utilize o conteúdo do ficheiro do acionador.

Escolha o modelo

Utilize a lista pendente de modelos no campo Documento para selecionar o modelo que suporta a extração. Considere o equilíbrio entre capacidade e velocidade:

  • Selecione um modelo mais capaz quando os documentos são longos, contêm tabelas complexas ou têm valores ambíguos.
  • Selecione um modelo mais rápido quando os documentos têm um formato consistente e o fluxo de trabalho corre em grande volume.

Teste o modelo selecionado com documentos representativos antes de publicar o fluxo de trabalho.

Extrato de um documento de exemplo

Use um documento de exemplo quando quiser que o nó de extração proponha campos e tabelas com base no conteúdo do documento.

  1. No nó de extração, selecione Sugerir campos a partir de um documento de exemplo.
  2. Carregue um documento representativo.
  3. Aguarde que o nó analise o documento e proponha campos.
  4. Revise os nomes de campos, descrições, tipos e tabelas sugeridos.
  5. Adicionar, remover, renomear ou editar campos conforme necessário.

Selecione um modelo

Use um modelo quando o seu documento seguir um formato empresarial comum e quiser começar com campos pré-definidos.

Captura de ecrã do diálogo de seleção de modelos do nó Extrair, que mostra os modelos de documento suportados.

  1. No nó de extração, selecione Selecionar um modelo.
  2. Selecione o modelo que melhor se adequa ao seu tipo de documento.
  3. Revise os nomes de campos, descrições, tipos e tabelas sugeridos.
  4. Adicionar, remover, renomear ou editar campos conforme necessário.

Adicionar campos manualmente

Use a configuração manual quando souber exatamente que informação o fluxo de trabalho precisa, ou quando um documento ou modelo de exemplo não corresponder ao seu cenário.

  1. No nó de extração, selecione Adicionar manualmente.
  2. Entra um Nome claro e único. O nome torna-se o token de conteúdo dinâmico que os passos seguintes utilizam.
  3. Selecione um tipo que corresponda ao valor ou tabela que precisa de extrair.
  4. Opcionalmente, adicione uma Descrição que explique a informação a identificar no documento.
  5. Repete para cada campo ou tabela que o nó deve devolver.

Use um tipo de campo Lista para informações repetidas, como itens de fatura, produtos ou participantes.

Por exemplo, um esquema de extração de faturas pode incluir invoiceNumber, vendorName, invoiceDate, totalAmount, e uma lineItems lista.

Use valores extraídos no seu fluxo de trabalho

Quando o nó de extração é executado, cada campo que configuras torna-se conteúdo dinâmico que podes usar nas etapas seguintes.

  1. Seleciona a ação onde queres usar um valor extraído.
  2. Abre o seletor dinâmico de conteúdo no campo que queres preencher.
  3. Selecione o campo do passo Extrair.

Testar um nó de extração

Depois de adicionar um campo de saída válido, aparece o painel de Teste . Utilize o painel Test no painel lateral do agente para executar o nó de extração e inspecionar a respetiva saída.

Captura de ecrã do painel do nó Run do nó Extrair, com a área de carregamento do documento de teste destacada.

  1. Selecione o nó para abrir o seu painel lateral de propriedades.

  2. Adicione pelo menos um campo válido para ativar os painéis.

  3. Selecione a guia Teste .

  4. Carregue um documento de teste, introduza entradas manualmente ou use entradas de uma execução de fluxo de trabalho anterior.

  5. Selecione Executar teste.

A execução de teste executa o nó usando um documento de teste carregado ou um documento de execução de fluxo de trabalho previamente utilizado para apresentar a saída gerada. Os testes ajudam a verificar se o nó de extração corre com sucesso e produz o tipo de resposta que espera. Depois de gerar um resultado de teste, avalie a qualidade dessa resposta e determine quão bem corresponde às suas expectativas e requisitos.

Cenários de automação

O nó de extração funciona melhor como um passo de transformação: um passo anterior fornece um documento, o nó de extração transforma-o em valores nomeados, e os passos seguintes atuam sobre esses valores.

Processar faturas

Um fluxo de trabalho recebe uma fatura através de um carregamento de ficheiros, caixa de correio partilhada ou pasta SharePoint. O nó de extração devolve o número da fatura, detalhes do fornecedor, datas, montante total, informações fiscais e itens de linha.

Uma ação posterior cria um registo Dataverse, encaminha a fatura para aprovação ou envia uma notificação quando o total ultrapassa um limiar.

Processar anexos de email

Um fluxo de trabalho é ativado quando um email chega com um anexo a um documento. O nó de extração recupera informações do cliente ou da conta do anexo e, posteriormente, cria ou atualiza registos num sistema empresarial.

Documentos de rota para revisão

Um fluxo de trabalho recebe um contrato ou relatório do SharePoint. O nó de extração identifica detalhes chave, como a data do contrato, o nome da parte ou o montante. Uma condição encaminha o documento para o aprovador apropriado e atualiza os seus metadados.

Extrair informação de relatórios

Um fluxo de trabalho recebe relatórios recorrentes num formato consistente. O nó de extração devolve os valores necessários para ações a jusante, como criar tarefas, atualizar registos ou enviar um resumo para um canal do Teams.

Perguntas frequentes

Quando devo usar o nó de extração em vez de um nó agente?

Utilize o nó de extração para extração focada em documentos numa estrutura definida. Utilize um nó de agente quando o fluxo de trabalho necessitar de raciocínio mais abrangente, ferramentas, conhecimentos ou execução de tarefas em várias etapas.

Posso editar campos gerados a partir de um documento ou modelo de exemplo?

Yes. Podes adicionar, remover, renomear e refinar campos e tabelas antes de guardar a configuração do nó de extração.

Posso extrair dados repetitivos?

Yes. Use um campo de tabela para informações repetidas, como itens de fatura, produtos ou outras linhas de um documento.

O nó de extração substitui o nó agente?

No. O nó de extração é uma experiência especializada de processamento de documentos criada com base na base no nó de agente. Utilize o nó de extração quando o principal objetivo for a extração estruturada de documentos.

Conteúdo relacionado

  • Last updated on