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 a 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): Añade 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 mensaje especificado en OpenAI y se pretende usar como destino en una operación.

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

• Register Tools V2: Añade 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 mensaje 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.

Requisitos previos y versiones de API compatibles

El conector de OpenAI requiere el uso de una versión de agente 10.1 o posterior. Estas versiones de agente descargan automáticamente la versión más reciente del conector cuando es necesario.

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 Prueba en la configuración de conexión para asegurar que la conexión sea exitosa y para verificar que se descargue la versión más reciente del conector en el agente (a menos que se use la política de organización Deshabilitar actualización automática de 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: Construir un mensaje desde 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.