Trabalhando com arquivos

Os agentes são compatíveis com o trabalho com arquivos como entradas e saídas. Isso permite que você transfira arquivos de processos do Maestro, fluxos de trabalho de RPA ou execuções de agentes independentes e receba arquivos de ferramentas que os geram.

Esta seção descreve como configurar Agents para aceitar arquivos, quais ferramentas são compatíveis com o tratamento de arquivos, limitações conhecidas e exemplos para integrar entradas de arquivos em diferentes ambientes de execução.

Preparação de um agente para aceitar arquivos

1. Abra a definição do agente.
2. No Gerenciador de dados, crie uma nova entrada.
3. Altere o tipo de entrada para Arquivo usando o seletor de tipo.

Um agente também deve incluir pelo menos uma ferramenta capaz de processar o arquivo.Agents não processam arquivos diretamente sem uma ferramenta. As seguintes ferramentas podem aceitar ou produzir arquivos:

• Fluxos de trabalho de RPA – Fluxos de trabalho contendo atividades que processam arquivos.

• IXP - Modelos personalizados ou modelados para extrair campos de documentos estruturados, semiestruturados ou não estruturados.

• Analisar arquivos – Envia arquivos compatíveis diretamente para o modelo.

  

As ferramentas a seguir ainda não são compatíveis com entradas ou saídas de arquivos. O suporte a arquivos é esperado nas próximas versões.

• Fluxos de trabalho da API
• Servidores MCP
• Atividades do Integration Service – Como solução alternativa, você pode usar fluxos de trabalho de RPA para lidar com operações de arquivos.
• Escalonamentos – Para trabalhar com arquivos, primeiro carregue o arquivo para um bucket de armazenamento e, em seguida, importe-o e exiba-o usando o Visualizador de documentos e a variável Arquivo de App.

Passagem de arquivos de um processo Maestro

Para passar um arquivo para um agente dentro de um processo do Maestro:

1. Certifique-se de que o processo inclua uma atividade ou fluxo de trabalho que produza um arquivo como saída.
2. Ou adicione um argumento de tipo de arquivo se o processo receber um arquivo no início.

3. Adicione o agente com uma entrada de arquivo e mapeie a variável de arquivo para a entrada do agente.
4. Execute o processo no modo de depuração ou implantação; o agente pode receber arquivos de Runtime.

Passagem de arquivos de um fluxo de trabalho de RPA

Para passar um arquivo de um fluxo de trabalho de RPA:

1. Certifique-se de que uma atividade ou disparar no fluxo de trabalho produza um arquivo.
2. Use a atividade Executar trabalho e referência um agente que tenha uma entrada de arquivo.

Observação:

O Studio Desktop 2025.10.0 ou posterior é necessário para suporte a arquivos.

Uso de arquivos em avaliações

Quando um agente define um argumento de entrada do tipo arquivo, a configuração de avaliação permite carregar ou selecionar arquivos que são usados como entradas de teste durante execuções de avaliações. Isso torna possível validar o comportamento do agente em comparação com documentos ou imagens reais, como capturas de tela, PDFs ou outros tipos de arquivo compatíveis.

Para usar arquivos em avaliações:

1. Abra o agente e navegue até Conjuntos de avaliações.
2. Crie uma nova avaliação ou edite uma existente.
3. No painel Configuração de entrada, localize o campo Entrada do Arquivo.
4. Carregue um novo arquivo ou selecione um entre os arquivos de avaliação disponíveis.
5. Salve a avaliação e execute o conjunto de avaliações.

O arquivo selecionado é passado para o agente da mesma forma que uma entrada de arquivo de runtime, garantindo um comportamento consistente entre avaliações e execuções de produção.

Ao trabalhar com entradas de arquivos em avaliações, você pode:

• Carregar arquivos diretamente do fluxo de configuração de avaliações
• Visualizar arquivos carregados anteriormente
• Selecionar qual arquivo usar para uma determinada entrada de avaliação

Os arquivos selecionados durante a configuração da avaliação são usados apenas para execuções de avaliação e não afetam as execuções do agente de produção.

Observação:

Os arquivos não são compatíveis no modo de simulação.