Transformação em lote

A ferramenta Transformação em lote permite que os agentes processem arquivos CSV em massa usando fontes de dados just-in-time (JIT).Ela é projetada para cenários em que você deseja aplicar a mesma lógica de transformação em cada linha ou registro em um arquivo CSV sem configurar buckets de armazenamento ou índices antecipadamente.

A Transformação em lote pega um arquivo CSV de entrada fornecido no runtime e aplica uma tarefa de transformação definida pelo usuário ao arquivo. A ferramenta processa o arquivo, linha a linha, e produz um ou mais arquivos de saída que incluem os dados originais junto com quaisquer colunas ou linhas adicionais geradas pela lógica de transformação.

Os casos de uso típicos incluem:

• Enriquecer arquivos CSV com pontuações, rótulos ou classificações gerados por modelos
• Aplicar regras de negócios ou lógica de decisão a grandes conjuntos de dados.
• Produzir explicações ou justificativas junto com decisões automatizadas

Fontes de Dados

• A Transformação em lote é compatível apenas com fontes de dados JIT.
• Apenas arquivos CSV são compatíveis como entrada.
• Os arquivos são passados diretamente por meio de entradas do agente e resolvidos automaticamente no runtime.
• Nenhuma configuração de armazenamento externo ou criação de índice é necessária.

Para obter detalhes, consulte Melhores práticas para DeepRAG e Transformação em lote: JIT versus estratégias baseadas em índices.

Configuração da Transformação em lote

Adicione a ferramenta Transformação de lote

1. Abra seu agente no Modo de design.
2. Na lista de ferramentas integradas, adicione Transformação em lote ao agente.

Uma vez adicionada, a ferramenta Transformação em lote aparece como um nó de ferramenta dedicado que você pode configurar a partir do painel do lado direito.

Configurar entradas

Durante o design, você especifica como a ferramenta deve receber sua entrada:

• Arquivo de origem: a origem é uma entrada de arquivo (por exemplo, input-csv). No runtime, isso é resolvido automaticamente para o arquivo fornecido quando o agente é executado.

  Observação:

  Você deve configurar um argumento de tipo de arquivo no Gerenciador de dados.

• Tarefa de transformação em lote - a instrução específica da ferramenta que define como a transformação em lote deve ser realizada. Use esse campo para dizer à ferramenta exatamente como processar o arquivo de entrada, incluindo:

  • Quais novas colunas ou linhas gerar
  • Como cada linha deve ser processada
  • Quaisquer regras, critérios ou lógica de decisão a aplicar

  Por exemplo, você pode instruir a ferramenta a gerar duas colunas novas, como uma pontuação e um sinalizador de recomendação com base no conteúdo de cada linha. Isso não é uma solicitação de agente. O agente deve incluir apenas uma instrução de alto nível para quando invocar a transformação em lote e como deve ser a saída final.

  

• Colunas de saída — Defina o esquema para quaisquer colunas novas geradas pela transformação em lote. Para cada coluna, especifique:

  • O nome da coluna
  • Uma descrição do que a coluna representa e como seus valores devem ser interpretados

  Você pode adicionar novas colunas de saída, editar nomes de colunas ou descrições existentes ou remover colunas conforme necessário. A tarefa Transformação em lote deve descrever a lógica usada para preencher essas colunas configuradas.

Habilitar embasamento de pesquisa na Web (opcional)

A ferramenta Transformação em lote inclui uma configuração opcional de embasamento de pesquisa na Web que controla se o modelo pode usar resultados de pesquisa na Web ao gerar transformações.

• Quando habilitado, o modelo pode complementar os dados do arquivo de entrada com informações recuperadas da Web ao processar cada linha.
• Quando desabilitado, a transformação é realizada estritamente usando o conteúdo do arquivo de entrada, as instruções definidas na tarefa e qualquer contexto fornecido explicitamente ao agente.

Observação:

Batch Transform with Web Search requires an LLM configuration for Gemini models.

Execução da Transformação em lote

Quando você executa ou depura o agente, a ferramenta Transformação em lote é executada como parte da execução do agente:

• O arquivo de entrada é passado para a ferramenta no runtime.
• A ferramenta processa o arquivo, linha por linha.
• É gerado um arquivo de saída transformado.
• O Arquivo de saída é retornado como parte da saída do agente.

Durante a execução, a Transformação em lote aparece no Trace de execução como uma chamada de ferramenta dedicada. Você pode expandir essa etapa para inspecionar informações detalhadas do runtime.

Inspecionar detalhes de execução

Do trace de execução, você pode revisar detalhes exibidos na saída da chamada de ferramenta e, quando aplicável, a saída do agente:

• Entradas - O arquivo de entrada usado pela ferramenta, incluindo nome do arquivo, tipo e metadados (visíveis na saída da chamada de ferramenta).
• Saídas - O arquivo de saída gerado, incluindo ID do arquivo, nome do arquivo e tipo MIME (exibido na saída da chamada de ferramenta quando uma saída de arquivo é definida).
• Contexto da solicitação - as solicitações do sistema e do usuário usadas durante a execução do agente, que ajudam a explicar como a tarefa de transformação foi executada.

Você pode baixar os arquivos de entrada e saída diretamente do trace de execução para validação ou solução de problemas.

Quando uma saída de arquivo é definida, a saída final do agente normalmente inclui uma mensagem de confirmação indicando que o arquivo transformado foi gerado e fornecendo o nome do arquivo de saída.