Transformação em lote

Ferramenta de agente integrada que processa um arquivo CSV linha por linha e adiciona colunas que a IA gera com base em uma tarefa que você define.

O que faz

Transformação em lote é uma ferramenta integrada que processa um arquivo CSV linha por linha e adiciona colunas que a IA gera para ele. Você fornece 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ê anexa a Transformação em lote a um Agente autônomo como uma ferramenta. O agente chama a ferramenta durante o raciocínio, passando a ela o arquivo de origem e a tarefa, e usa o arquivo transformado no restante do seu trabalho.

O nó é rotulado Transformação em lote na paleta, na categoria de ferramentas integradas.

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 a ferramenta à tela e, em seguida, conecte-a a um agente.

1. Selecione um nó do Agente autônomo ou adicione um se seu fluxo ainda não o tiver.
2. Abra a paleta de nós e selecione a categoria Ferramentas integradas.
3. Selecione Transformação em lote. O fluxo 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 da 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 para transformar. Faça referência a um arquivo produzido anteriormente no fluxo, ou um que o agente fornece quando ele 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ó preenche um objeto error em vez disso. Consulte Tratamento de erros para obter 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 que o início do fluxo envia.

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.

Páginas relacionadas

• Agente
• Extração de documentos
• Tratamento de Erro