Transformação em lote

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

O que faz

A Transformação em lote é uma ferramenta integrada 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ê anexa 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.

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 para uma nova coluna.
• Extraia um valor de um campo de texto livre para sua própria coluna.
• Pontuar, resumir ou marcar 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 documento . Para analisar o conteúdo de arquivos que não são CSVs orientados por linha, 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ó de Agente Autônomo ou adicione um se seu fluxo ainda não tiver um.
2. Abra a paleta do nó 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 até o identificador da ferramenta do agente.
5. Selecione o nó de Transformação em lote para abrir seu painel de propriedades e configurá-lo.

Resultado: a ferramenta Transformação em lote é conectada ao agente. O agente agora pode chamá-lo enquanto raciocina.

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 a ser transformado. Faça referência a um arquivo produzido upstream no fluxo 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	O conteúdo que a coluna deve conter. 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 fundamentar ou enriquecer seus resultados. Selecione Desabilitado para usar apenas o arquivo e a tarefa de origem.

Entradas e saídas

Entrada

A Transformação em lote recebe sua entrada dos campos que você configura: o CSV de origem, a tarefa, as colunas de saída e a configuração de embasamento de pesquisa na Web. Como é executado 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 $vars.<nodeName>.output, onde <nodeName> é o nome do nó de Transformação em lote.

$vars.batchTransform1.output

Se a ferramenta falhar, o nó preencherá um objeto error em vez disso. Consulte o Tratamento de erros para obter o formato de 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

Triar um CSV de tíquetes de suporte

Um agente recebe um CSV de tíquetes de suporte e precisa que cada tíquete seja categorizado e priorizado antes de encaminhá-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.

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 de faturamento, técnico ou de conta, com base no assunto e do corpo do tíquete.
• Priority entre 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 um Category e uma coluna Priority adicionada 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