Transformação em lote

Add the Batch transform tool to an agent, configure its task and output columns, and read its result, with an example.

O que faz

A Transformação em lote é um nó que processa um arquivo CSV, linha a linha, e adiciona colunas geradas por IA a ele. Você dá a ele um CSV de origem, uma tarefa que descreve o que fazer para cada linha e as colunas que você deseja adicionar. Ele retorna um novo arquivo com essas colunas preenchidas.

Você pode anexar a Transformação em lote a um agente autônomo como uma ferramenta. O agente chama a ferramenta enquanto raciocina, passando-a para o arquivo de origem e a tarefa, e usa o arquivo transformado no restante de seu trabalho.

No painel Adicionar nó , a transformação em lote está em Dados.

Quando usar

Use a Transformação em lote quando um agente precisar enriquecer ou classificar as linhas de um CSV em massa e cada linha precisar do mesmo tratamento orientado por IA.

Tarefas típicas:

• Classifique cada linha em uma categoria e escreva o rótulo em uma nova coluna.
• Extraia um valor de um campo de texto livre para sua própria coluna.
• Pontue, resuma ou marque cada linha com base em suas colunas existentes.

Para extrair dados estruturados de um único documento em vez de transformar linhas tabulares, conecte um recurso de Extração de documentos. Para analisar o conteúdo de arquivos que não são CSVs orientados a linhas, use a ferramenta integrada Analisar arquivos.

Adicionando a ferramenta

Adicione o nó à tela e, em seguida, conecte-o a um agente.

1. Selecione um nó de Agente Autônomo ou adicione um se seu fluxo de trabalho ainda não tiver um.
2. Abra o painel Adicionar nó e selecione a categoria Dados .
3. Selecione Transformação em lote. O Maestro Automate adiciona o nó à tela.
4. Desenhe uma borda do nó Transformação em lote para o identificador de ferramenta do agente.
5. Selecione o nó Transformação em lote para abrir seu painel de propriedades e configurá-lo.

Resultado: a ferramenta Transformação em lote conecta-se ao agente.O agente agora pode chamá-lo durante o raciocínio.

Referência de configuração

Configure esses campos na seção Configurações de transformação em lote do painel de propriedades.

Campo	Required	Padrão	Description
Origem (arquivo)	Sim	Nenhum	Arquivo CSV a ser transformado. Faça referência a um arquivo produzido upstream no fluxo de trabalho ou que o agente fornece quando chama a ferramenta.
Tarefa de transformação em lote	Sim	Nenhum	Instruções que a ferramenta aplica a cada linha. Descreva o que analisar, o que extrair e como preencher as colunas de saída.
Colunas de Saída	Sim	Nenhum	Colunas que a ferramenta adiciona ao arquivo. Defina pelo menos uma coluna com um nome e descrição e adicione até 10 colunas.
Nome da coluna	Sim	Nenhum	Cabeçalho para a nova coluna no arquivo de saída.
Description	Sim	Nenhum	Conteúdo que a coluna deve ter. A ferramenta usa esse valor para decidir o que escrever para cada linha, portanto, seja específico sobre o formato esperado.
Embasamento de pesquisa na Web	Não	Habilitado	Se a ferramenta pode usar a pesquisa na web para embasar ou enriquecer seus resultados. Selecione Desabilitado para usar apenas o arquivo de origem e a tarefa.

Entradas e saídas

Entrada

A Transformação em lote tira sua entrada dos campos que você configurar: o CSV de origem, a tarefa, as colunas de saída e a configuração de embasamento de pesquisa na Web. Como ela funciona como uma ferramenta, o agente de chamada fornece esses valores quando invoca a ferramenta durante uma execução.

Saída

A Transformação em lote retorna um arquivo: o CSV de origem com as colunas de saída anexadas e preenchidas. Acesse-o em $vars.<nodeName>.output, onde <nodeName> é o nome do nó da Transformação em lote.

$vars.batchTransform1.output

Se a ferramenta falhar, o nó preencherá um objeto error em vez disso. O tratamento de erros descreve o formato do erro e como rotear nele.

{
  "output": "file. The source CSV with the configured output columns added and populated.",
  "error": "object. Populated only on failure. See Error handling."
}

Exemplo

Triagem de um CSV de tíquetes de suporte

Um agente recebe um CSV de tíquetes de suporte e precisa categorizar e priorizar cada tíquete antes de roteá-los.

Conecte uma ferramenta de Transformação em lote ao agente e configure-a da seguinte forma.

Origem (arquivo): o CSV dos tíquetes, por exemplo, um arquivo passado desde o início do fluxo de trabalho.

Tarefa de transformação em lote:

For each ticket, read the Subject and Body columns. Classify the ticket into exactly one category: billing, technical, or account. Then assign a priority of high, medium, or low based on the urgency expressed in the text.

Colunas de saída:

• Category: um de faturamento, técnico ou conta, com base no assunto e no corpo do tíquete.
• Priority: um de alto, médio ou baixo, refletindo a urgência do tíquete.

Quando o agente chama a ferramenta, a Transformação em lote retorna o CSV original com uma coluna Category e uma coluna Priority adicionadas para cada linha. O agente usa esse arquivo enriquecido, disponível em $vars.batchTransform1.output, no restante de sua tarefa.

Próximas Etapas

• Agente autônomo: o agente que chama a Transformação em lote como uma ferramenta.
• Extração de documentos: extraia dados estruturados de um único documento.
• Tratamento de erro: rotear no objeto error quando a ferramenta falhar.
• Comunidade: faça perguntas e compartilhe fluxos de trabalho com outros construtores no Fórum da UiPath.