Conector OpenAI en Jitterbit Studio

Resumen

El conector OpenAI establece acceso a OpenAI.

El conector OpenAI proporciona una interfaz para crear una conexión OpenAI, la base utilizada para generar instancias de actividades OpenAI. Estas actividades, una vez configuradas, interactúan con OpenAI a través de la conexión.

Se accede al conector OpenAI desde la pestaña Project endpoints and connectors (Puntos finales y conectores del proyecto) de la paleta de componentes de diseño (consulta Design component palette).

Descripción general del conector

Este conector se utiliza primero para configurar una conexión OpenAI. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que se pretende usar como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión OpenAI específica y sus actividades se denominan punto final OpenAI:

• Create Transcription: Transcribe audio a texto según el idioma de entrada detectado en OpenAI y se pretende usar como destino en una operación.

• Register Tools (Deprecated): Agrega herramientas a un asistente en OpenAI y se pretende usar como destino en una operación.

  Advertencia

  La actividad Register Tools (Deprecated) está deprecada y ya no es compatible. En una próxima versión, esta actividad se eliminará permanentemente. Fue reemplazada en la versión 12.8 por la actividad rediseñada Register Tools V2, cuyo uso de la API de Respuestas de OpenAI permite persistir registros de herramientas en operaciones en grupos de agentes en la nube, no solo en agentes privados.

• Create Image: Crea imágenes basadas en un indicador especificado en OpenAI y se pretende usar como destino en una operación.

• Prompt V2: Crea una respuesta para el indicador proporcionado usando la API de Respuestas de OpenAI y se pretende usar como destino en una operación.

• Register Tools V2: Agrega herramientas a un asistente usando la API de Respuestas de OpenAI y se pretende usar como destino en una operación.

• Register MCP Server Tools: Registra un servidor MCP remoto como proveedor de herramientas con OpenAI y se pretende usar como destino en una operación.

• Prompt (Deprecated): Crea una finalización de texto para el indicador proporcionado en OpenAI y se pretende usar como destino en una operación.

  Advertencia

  La actividad Prompt (Deprecated) está deprecada y ya no es compatible. En una próxima versión, esta actividad se eliminará permanentemente. Fue reemplazada en la versión 12.8 por la actividad rediseñada Prompt V2, cuyo uso de la API de Respuestas de OpenAI permite persistir el contexto de chat e invocar herramientas registradas en grupos de agentes en la nube, no solo en agentes privados.

• Crear actividad de traducción: Traduce archivos de audio a texto en inglés en OpenAI y está diseñada para usarse como destino en una operación.

Los puntos de conexión creados con este conector se incluyen en reportes de uso de puntos de conexión y cuentan hacia tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede usar con agentes en la nube y agentes privados.

Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política de organización Disable Auto Connector Update.

El conector de OpenAI utiliza la API de OpenAI. Consulta la documentación de la API para obtener información sobre los nodos de esquema y los campos.

Modelos de OpenAI compatibles

Este conector es compatible con estos modelos de OpenAI:

• GPT-3.5 Turbo

• Modelos GPT-4:

  • gpt-4
  • gpt-4-turbo

• Modelos GPT-4o:

  • gpt-4o
  • gpt-4o-mini

• Modelos GPT-4.1:

  • gpt-4.1
  • gpt-4.1-mini
  • gpt-4.1-nano

• Modelos GPT-5:

  • gpt-5
  • gpt-5-chat-latest
  • gpt-5-mini
  • gpt-5-nano

• Modelos GPT-5.1:

  • gpt-5.1
  • gpt-5.1-chat-latest

• Modelos GPT-5.2:

  • gpt-5.2
  • gpt-5.2-chat-latest

• Modelos GPT-5.3:

  • gpt-5.3-chat-latest

• Modelos GPT-5.4:

  • gpt-5.4
  • gpt-5.4-mini
  • gpt-5.4-nano

• GPT-5.5

• Modelos GPT-5.6:

  • gpt-5.6-sol
  • gpt-5.6-terra
  • gpt-5.6-luna

• GPT Image 2

• Modelos de la serie o:

  • o1
  • o3
  • o3-mini
  • o4-mini-2025-04-16

• Whisper (whisper-1)

Solución de problemas

Si experimentas problemas con el conector de OpenAI, se recomiendan estos pasos para la solución de problemas:

1. Haz clic en el botón Probar en la configuración de conexión para asegurar que la conexión sea exitosa y para descargar la versión más reciente del conector al agente (a menos que se use la política de organización Deshabilitar actualización automática del conector).

2. Revisa los registros de operación para obtener cualquier información escrita durante la ejecución de la operación.

3. Habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

4. Si usas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registrador al archivo logback.xml de tu agente privado:

   <logger name="org.jitterbit.connector.openai" level="DEBUG"/>
   

   Para obtener más información sobre el registro detallado del conector, consulta Registro detallado para conectores usando agentes privados de Jitterbit.

5. Si usas agentes privados, puedes revisar los registros del agente para obtener más información.

6. Para consideraciones adicionales sobre la solución de problemas, consulta Solución de problemas de operación.

Verlo en la práctica

• Usar OpenAI para procesar datos en una operación de Studio: Crear un mensaje a partir de datos de origen, enviarlo a OpenAI y enrutar la respuesta de IA a un destino descendente.
• Procesar documentos con IA: Extraer datos estructurados de documentos no estructurados usando el conector de OpenAI.
• Enrutar respuestas de LLM a operaciones de Studio usando llamadas de función: Usar la llamada de función de OpenAI para enrutar dinámicamente la salida de LLM a diferentes operaciones de Studio.