Processar documentos com IA no Jitterbit Studio

Introdução

O conector Google Docs e o conector OpenAI podem ser combinados para criar pipelines de processamento de documentos no Studio. Este guia aborda um padrão comum: buscar um documento do Google Docs pelo ID, passar seu conteúdo de texto para o OpenAI com um prompt que instrui o modelo como processá-lo e publicar o resultado gerado por IA em um canal Slack.

Os casos de uso típicos incluem resumo de anotações de reuniões, análise de contratos e extração de dados estruturados de documentos não estruturados.

Este guia se concentra nas partes específicas do documento da integração: configurar a conexão do Google Docs, mapear o conteúdo do documento no prompt e rotear a resposta de IA. Para a configuração da conexão OpenAI e configuração geral da atividade Prompt, consulte Usar OpenAI para processar dados em uma operação Studio.

Padrão de design

A integração usa duas operações encadeadas:

A Operação 1 usa duas transformações: uma transformação de requisição que mapeia o ID do documento no esquema de requisição Get Docs e uma transformação que mapeia o campo content retornado no campo prompt do OpenAI. A Operação 2 lê a resposta de IA da atividade Prompt e a publica em um canal Slack.

Parte 1: Configurar a conexão e atividade do Google Docs

Etapa 1: Criar a conexão do Google Docs

1. No Studio, abra seu projeto e clique na guia Project endpoints and connectors na paleta de componentes de design.

2. Clique no conector Google Docs para abrir a configuração de conexão.

3. Connection Name: Digite um nome que identifique esta conexão, por exemplo Google Docs.

4. Configure a autenticação conforme descrito em Pré-requisitos do Google Docs.

5. Clique em Test para verificar a conexão e depois clique em Save Changes.

Etapa 2: Configurar a atividade Get Docs

1. Na paleta de componentes de design, expanda o endpoint do Google Docs que você criou. Arraste o tipo de atividade Get Docs para a tela de design a fim de criar uma instância de atividade.

2. Clique duas vezes na atividade para abrir sua configuração.

3. Name: Digite um nome para a atividade, por exemplo Get Document.

4. Clique em Next para revisar os esquemas de dados e depois clique em Finished.

A atividade Get Docs usa estes campos de esquema:

• Request: docid: o ID do documento do Google Doc a ser recuperado.
• Response: docname (título do documento), content (texto do corpo do documento) e errormsg (mensagem de erro, se houver).

O ID do documento aparece na URL do Google Docs: https://docs.google.com/document/d/<document-id>/edit.

Etapa 3: Mapear o ID do documento

Adicione uma transformação de requisição antes da atividade Get Docs para fornecer o ID do documento. Mapeie o campo de requisição docid usando uma variável de projeto para que o ID possa ser alterado sem editar a transformação:

<trans>
$google_docs_document_id
</trans>

Parte 2: Mapear o conteúdo do documento para o prompt do OpenAI

Antes de configurar a transformação, configure a conexão OpenAI e a atividade Prompt conforme descrito em Usar OpenAI para processar dados em uma operação Studio.

Na transformação entre a atividade Get Docs (origem) e a atividade Prompt do OpenAI (destino), mapeie os seguintes campos.

Mapear o prompt

Mapeie o campo prompt do OpenAI para combinar uma instrução estática com o corpo do documento. Use Source.content para referenciar o campo content do esquema de resposta Get Docs:

<trans>
"Summarize the following meeting notes in three bullet points:\n\n" +
Source.content
</trans>

Solicitar saída estruturada

Se o processamento posterior exigir um formato previsível, inclua instruções de formatação no prompt:

<trans>
"Extract the key decisions and action items from the following meeting notes. " +
"Return the result as a JSON object with these fields: " +
"\"summary\" (a one-sentence overview), \"decisions\" (an array of strings), " +
"\"action_items\" (an array of strings).\n\n" +
Source.content
</trans>

Para orientações sobre análise de respostas JSON estruturadas em uma operação posterior, consulte Rotear respostas do LLM para operações do Studio usando function calling.

Tratar erros do Get Docs

Adicione um nó de script à transformação para expor erros retornados pela atividade Get Docs:

<trans>
if(Source.errormsg != "",
  RaiseError("Google Docs error: " & Source.errormsg)
);
</trans>

Parte 3: Acessar a resposta da IA e postar no Slack

Encadear a operação do Slack

Configure a ação On Success da operação OpenAI para executar a operação Slack posterior:

1. Abra as configurações da operação OpenAI.

2. Na aba Actions, defina a ação On Success como Run Operation e selecione a operação Slack.

Para mais informações sobre encadeamento de operações, consulte Configurar tratamento de erros em operações.

Mapear a resposta da IA

Na transformação da operação Slack, mapeie choices[0].message.content do esquema de resposta da atividade Prompt para o campo text da mensagem Slack:

<trans>
Source.choices[0].message.content
</trans>

Tratar erros do OpenAI

Adicione um nó de script para gerar um erro se o OpenAI retornar um array errors não vazio:

<trans>
if(Length(Source.errors) > 0,
  RaiseError(Source.errors[0].message)
);
</trans>

Para as etapas completas de configuração de conexão e mensagem do Slack, consulte Enviar uma notificação do Slack de uma operação do Studio.

Verificar a integração

1. Implante e execute a operação Get Docs manualmente.

2. Nos logs da operação, confirme que a atividade Get Docs foi concluída com sucesso e que o campo content contém o texto do documento esperado.

3. Confirme que a operação Prompt do OpenAI foi acionada e concluída com sucesso.

4. Inspecione o log da operação OpenAI para verificar que choices[0].message.content contém uma resposta válida gerada pela IA.

5. Verifique o canal do Slack para o resultado postado.

Se a atividade Get Docs retornar um campo content vazio, verifique se a ID do documento está correta e se a conta de serviço configurada na conexão do Google Docs tem acesso de leitura ao documento.