Processar documentos com IA no Jitterbit Studio

Introdução

O conector do Google Docs e o conector do OpenAI podem ser combinados para construir pipelines de processamento de documentos no Studio. Este guia cobre 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 sobre como processá-lo e postar o resultado gerado pela IA em um canal do Slack.

Casos de uso típicos incluem a sumarização de notas de reuniões, análise de contratos e extração de dados estruturados de documentos não estruturados.

Este guia foca 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 direcionar a resposta da IA. Para a configuração da conexão do OpenAI e a configuração geral da atividade Prompt, veja Usar o OpenAI para processar dados em uma operação do 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 solicitação que mapeia o ID do documento no esquema de solicitação Obter Documentos, e uma transformação que mapeia o campo content retornado no campo prompt do OpenAI. A Operação 2 lê a resposta da IA da atividade Prompt e a posta em um canal do Slack.

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

Passo 1: Criar a conexão do Google Docs

1. No Studio, abra seu projeto e clique na aba Endpoints e conectores do projeto na paleta de componentes de design.

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

3. Nome da Conexão: Insira 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 Testar para verificar a conexão e, em seguida, clique em Salvar Alterações.

Etapa 2: Configure a atividade Get Docs

1. No painel 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 para criar uma instância da atividade.

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

3. Nome: Insira um nome para a atividade, por exemplo Get Document.

4. Clique em Próximo para revisar os esquemas de dados e, em seguida, clique em Finalizado.

A atividade Get Docs utiliza os seguintes 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: Mapeie o ID do documento

Adicione uma transformação de solicitação antes da atividade Get Docs para fornecer o ID do documento. Mapeie o campo de solicitaçã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: Mapeie 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 Use OpenAI para processar dados em uma operação de Studio.

Na transformação entre a atividade Get Docs (fonte) 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 do Get Docs:

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

Solicitar saída estruturada

Se o processamento a montante 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 como analisar respostas JSON estruturadas em uma operação a montante, veja Roteie respostas LLM para operações do Studio usando chamada de função.

Lidar com erros do Get Docs

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

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

Parte 3: Acesse a resposta da IA e publique no Slack

Encadear a operação do Slack

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

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

2. Na aba Ações, defina a ação On Success como Executar Operação e selecione a operação do Slack.

Para mais informações sobre como encadear operações, veja Configure o tratamento de erros em operações.

Mapear a resposta da IA

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

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

Lidar com 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 etapas completas de configuração da conexão e mensagem do Slack, veja Envie uma notificação do Slack a partir de uma operação do Studio.

Verifique 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 OpenAI Prompt foi acionada e concluída com sucesso.

4. Inspecione o log da operação OpenAI para verificar se 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 o ID do documento está correto e se a conta de serviço configurada na conexão do Google Docs tem acesso de leitura ao documento.