Transmitir arquivos para fluxos de agente, conectores e ferramentas

Passe arquivos do agente do Copilot Studio para sistemas downstream usando fluxos de agente, conectores e ferramentas. Essa funcionalidade habilita cenários avançados de automação, como a criação de tickets com anexos, processamento de documentos e muito mais.

Ativar entrada de arquivo

Os criadores podem permitir que os usuários do agente carreguem arquivos durante as interações de chat com o agente. Crie um novo tópico para obter o arquivo do usuário.

Existem três opções diferentes para solicitar o arquivo.

Interação do nó de pergunta

A primeira opção é feita usando um nó de Pergunta.

1. Adicione um nó de Pergunta em um tópico.

2. Em Identificar, selecione Arquivo.

3. Selecione Mais (...) >Propriedades para abrir o painel de propriedades da pergunta.

4. Selecione a categoria reconhecimento de entidade.

5. Selecione Incluir metadados do arquivo.

Definir uma variável

A próxima opção é definir uma variável com valor definido pela fórmula PowerFx First(System.Activity.Attachments). Essa variável permite que você determine se um arquivo já está anexado, por exemplo, em uma conversa do Microsoft Teams. Para usar essa opção, em seu tópico, use um nó Definir valor da variável para recuperar o arquivo anexado e os metadados como um registro. Você pode então extrair e passar os campos .Name e .Content do arquivo como variáveis separadas e passá-los para ações.

Combinar as opções

Você pode usar as duas opções juntas. Comece usando a variável definida pela fórmula First(System.Activity.Attachments) para verificar se um arquivo já está anexado. Em seguida, use um nó da Condição para ir para um nó de Pergunta quando a condição for falsa. O nó Pergunta pede para o usuário carregar um arquivo.

Essa opção permite que o tópico seja executado automaticamente se o usuário iniciar o fluxo da conversa e anexar um arquivo na mesma conversa. Por exemplo, se o usuário disser: “Envie um email com este arquivo my.file.”

No entanto, se o usuário disser “Envie um email com este arquivo”, mas não anexar o arquivo, o agente pede ao usuário que forneça o arquivo antes de continuar a conversa.

Transmitir um arquivo de usuário para um fluxo do Power Automate

Para passar o arquivo de usuário para um fluxo do Power Automate, adicione um fluxo do agente em seu tópico após o nó de Pergunta que solicita um arquivo. Uma variável no fluxo do agente recebe o arquivo do Copilot Studio.

Opcionalmente, você pode adicionar lógica ao seu fluxo para enviar este arquivo para SharePoint, ServiceNow, Dynamics 365 Customer Service e serviços similares. Para passar a variável, use esta fórmula do Power Fx:

{ contentBytes: Topic.userReceipt.Content, name: Topic.userReceipt.Name }

Transmitir um arquivo de usuário para um fluxo do Power Automate que foi adicionado como ferramenta

Para passar um arquivo do usuário para um agente ou fluxo do Power Automate adicionado como ferramenta, execute as seguintes etapas:

1. Abra a página Ferramentas.

2. Selecione a ferramenta do fluxo.

3. Na página Detalhes da ferramenta, vá até Entradas.

4. Para o fluxo, você precisa das entradas ContentBytes e name. Se essas entradas estiverem faltando, selecione Adicionar entrada para adicioná-las.

5. Defina contentBytes como a seguinte fórmula:

   First(System.Activity.Attachments).Content
   

6. Defina name como a seguinte fórmula:

   First(System.Activity.Attachments).Name
   

7. Uma vez configuradas, as entradas devem ser exibidas conforme a configuração a seguir:

   

8. Em seguida, você pode selecionar Arquivo como o tipo de entrada do usuário no fluxo.

   

Passe um arquivo de usuário para um Conector

O mesmo princípio utilizado para enviar um arquivo de usuário para um fluxo do Power Automate também se aplica ao envio de arquivos para conectores. Para transmitir o arquivo de usuário para um conector, adicione uma ferramenta de um conector em seu tópico após o nó da Pergunta que solicita um arquivo. A variável no conector recebe o arquivo do seu agente.

O objeto de anexo utiliza a mesma fórmula Power Fx:

{ contentBytes: Topic.userReceipt.Content, name: Topic.userReceipt.Name }

Passe um arquivo de usuário para uma ferramenta

Na página Ferramentas, entradas de arquivo só funcionam quando você as define como uma fórmula Power Fx usando a opção Custom value. Não funciona ao usar a opção Preencher Dinamicamente com IA. Use a variável System.Activity.Attachments para preencher o valor usando uma fórmula Power Fx que seja compatível com a entrada do conector.

Esta fórmula do Power Fx é um exemplo:

If(
    IsEmpty(System.Activity.Attachments), 
    [], 
    [{ contentBytes: First(System.Activity.Attachments).Content, name: First(System.Activity.Attachments).Name }])

Informações relacionadas

• Permitir entrada de arquivos pelos usuários