Procesar documentos con IA en Jitterbit Studio

Introducción

El conector de Google Docs y el conector de OpenAI se pueden combinar para construir canalizaciones de procesamiento de documentos en Studio. Esta guía cubre un patrón común: obtener un documento de Google Docs por ID, pasar su contenido de texto a OpenAI con un indicador que le instruya al modelo cómo procesarlo y publicar el resultado generado por IA en un canal de Slack.

Los casos de uso típicos incluyen resumen de notas de reuniones, análisis de contratos y extracción de datos estructurados de documentos no estructurados.

Esta guía se enfoca en las partes específicas del documento de la integración: configurar la conexión de Google Docs, mapear el contenido del documento en el indicador y enrutar la respuesta de IA. Para la configuración de la conexión de OpenAI y la configuración general de la actividad Prompt, consulta Usar OpenAI para procesar datos en una operación de Studio.

Patrón de diseño

La integración utiliza dos operaciones encadenadas:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% flowchart LR A["Transformation
Map document ID"] --> B[Google Docs Get Docs] --> C["Transformation
Map content to prompt"] --> D[OpenAI Prompt] D -->|On Success| E["Transformation
Map AI response"] --> F[Slack Post Message]

La operación 1 utiliza dos transformaciones: una transformación de solicitud que mapea el ID del documento en el esquema de solicitud Get Docs, y una transformación que mapea el campo content devuelto en el campo prompt de OpenAI. La operación 2 lee la respuesta de IA de la actividad Prompt y la publica en un canal de Slack.

Parte 1: Configurar la conexión y la actividad de Google Docs

Paso 1: Crear la conexión de Google Docs

En Studio, abre tu proyecto y haz clic en la pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño.
Haz clic en el conector de Google Docs para abrir la configuración de conexión.
Nombre de la conexión: Ingresa un nombre que identifique esta conexión, por ejemplo Google Docs.
Configura la autenticación como se describe en Requisitos previos de Google Docs.
Haz clic en Test para verificar la conexión, luego haz clic en Save Changes.

Paso 2: Configurar la actividad Get Docs

En la paleta de componentes de diseño, expande el punto final de Google Docs que creaste. Arrastra el tipo de actividad Get Docs al lienzo de diseño para crear una instancia de actividad.
Haz doble clic en la actividad para abrir su configuración.
Nombre: Ingresa un nombre para la actividad, por ejemplo Get Document.
Haz clic en Next para revisar los esquemas de datos, luego haz clic en Finished.

La actividad Get Docs utiliza estos campos de esquema:

Request: docid: el ID del documento de Google Doc a recuperar.
Response: docname (título del documento), content (texto del cuerpo del documento) y errormsg (mensaje de error, si hay alguno).

El ID del documento aparece en la URL de Google Docs: https://docs.google.com/document/d/<document-id>/edit.

Paso 3: Mapear el ID del documento

Añade una transformación de solicitud antes de la actividad Get Docs para proporcionar el ID del documento. Mapea el campo de solicitud docid usando una variable de proyecto para que el ID se pueda cambiar sin editar la transformación:

<trans>
$google_docs_document_id
</trans>

Consejo

Para selección de documentos dinámica (por ejemplo, procesar el documento modificado más recientemente), establece google_docs_document_id en un paso de script que preceda a la operación Get Docs, usando resultados de una actividad Google Drive List Files.

Parte 2: Mapear el contenido del documento al indicador de OpenAI

Antes de configurar la transformación, configura la conexión de OpenAI y la actividad Prompt como se describe en Usar OpenAI para procesar datos en una operación de Studio.

En la transformación entre la actividad Get Docs (origen) y la actividad Prompt de OpenAI (destino), mapea los siguientes campos.

Asignar el prompt

Asigna el campo prompt de OpenAI para combinar una instrucción estática con el cuerpo del documento. Usa Source.content para hacer referencia al campo content del esquema de respuesta de Get Docs:

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

Solicitar salida estructurada

Si el procesamiento posterior requiere un formato predecible, incluye instrucciones de formato en el 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 obtener orientación sobre cómo analizar respuestas JSON estructuradas en una operación posterior, consulta Enrutar respuestas de LLM a operaciones de Studio usando function calling.

Manejar errores de Get Docs

Agrega un nodo de script a la transformación para mostrar los errores devueltos por la actividad Get Docs:

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

Parte 3: Acceder a la respuesta de IA y publicar en Slack

Encadenar la operación de Slack

Configura la acción On Success de la operación de OpenAI para ejecutar la operación de Slack posterior:

Abre la configuración de la operación de OpenAI.
En la pestaña Actions, establece la acción On Success en Run Operation y selecciona la operación de Slack.

Para obtener más información sobre encadenamiento de operaciones, consulta Configurar manejo de errores en operaciones.

Asignar la respuesta de IA

En la transformación de la operación de Slack, asigna choices[0].message.content del esquema de respuesta de la actividad Prompt al campo text del mensaje de Slack:

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

Manejar errores de OpenAI

Agrega un nodo de script para generar un error si OpenAI devuelve un array errors no vacío:

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

Para obtener los pasos completos de configuración de conexión y mensajes de Slack, consulta Enviar una notificación de Slack desde una operación de Studio.

Verificar la integración

Implementa y ejecuta la operación Get Docs manualmente.
En los registros de operación, confirma que la actividad Get Docs se completó exitosamente y que el campo content contiene el texto del documento esperado.
Confirma que la operación de Prompt de OpenAI se activó y se completó exitosamente.
Inspecciona el registro de la operación de OpenAI para verificar que choices[0].message.content contiene una respuesta válida generada por IA.
Verifica el canal de Slack para el resultado publicado.

Si la actividad Get Docs devuelve un campo content vacío, verifica que el ID del documento sea correcto y que la cuenta de servicio configurada en la conexión de Google Docs tenga acceso de lectura al documento.