Conector de OpenAI en Jitterbit Studio

Resumen

El conector de OpenAI establece acceso a OpenAI.

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

El conector de OpenAI se accede desde la pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).

Descripción general del conector

Este conector se utiliza para primero configurar una conexión de OpenAI. Los tipos de actividad asociados con esa conexión se utilizan luego para crear instancias de actividades que están destinadas a ser utilizadas como fuentes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

Juntos, una conexión específica de OpenAI y sus actividades se conocen como un punto final de OpenAI:

Tipos de actividades de OpenAI

Crear Transcripción: Transcribe audio a texto basado en el idioma detectado en OpenAI y está destinado a ser utilizado como un destino en una operación.
Registrar Herramientas: Agrega herramientas a un asistente en OpenAI y está destinado a ser utilizado como un destino en una operación.
Crear Imagen: Crea imágenes basadas en un aviso específico en OpenAI y está destinado a ser utilizado como un destino en una operación.
Prompt V2: Crea una respuesta para el aviso proporcionado utilizando la API de Respuestas de OpenAI y está destinado a ser utilizado como un destino en una operación.
Registrar Herramientas V2: Agrega herramientas a un asistente utilizando la API de Respuestas de OpenAI y está destinado a ser utilizado como un objetivo en una operación.
Registrar Herramientas del Servidor MCP: Registra un servidor MCP remoto como proveedor de herramientas con OpenAI y está destinado a ser utilizado como un objetivo en una operación.
Sugerencia: Crea una finalización de texto para la sugerencia proporcionada en OpenAI y está destinado a ser utilizado como un objetivo en una operación.
Crear Traducción: Traduce archivos de audio a texto en inglés en OpenAI y está destinado a ser utilizado como un objetivo en una operación.

Nota

Este conector es un conector basado en Connector SDK, que puede ser mencionado por Jitterbit al comunicar cambios realizados en conectores construidos con el Connector SDK.

Los puntos finales creados con este conector están incluidos en informes de uso de puntos finales y cuentan para su licencia.

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 última versión del conector cuando es necesario.

Importante

Debe utilizar un agente privado para la siguiente funcionalidad:

Para gestionar el historial de chat y mantener el contexto de la conversación entre llamadas a la API.
Para utilizar la actividad Registrar Herramientas.

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

Modelos de OpenAI soportados

Este conector soporta estos modelos de OpenAI:

GPT-3.5 Turbo
Modelos de GPT-4:
- gpt-4
- gpt-4-turbo
Modelos de GPT-4o:
- gpt-4o
- gpt-4o-mini
Modelos de GPT-4.1:
Modelos de GPT-5:
Modelos de GPT-5.1:
- gpt-5.1
- gpt-5.1-chat-latest
Modelos de GPT-5.2:
- gpt-5.2
- gpt-5.2-chat-latest
Modelos de GPT-5.3:
- gpt-5.3-chat-latest
Modelos de GPT-5.4:
GPT-5.5
GPT Image 2
modelos o-series:
Whisper (whisper-1)

Solución de problemas

Si se experimentan problemas con el conector de OpenAI, se recomiendan los siguientes pasos de solución de problemas:

Haga clic en el botón Probar en la configuración de conexión para asegurarse de que la conexión sea exitosa y de que la última versión del conector se descargue en el agente (a menos que se esté utilizando la política de organización Deshabilitar actualización automática del conector).
Revise los registros de operaciones para obtener información escrita durante la ejecución de la operación.
Habilite el registro de depuración de operaciones (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.
Si se utilizan agentes privados, se puede habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registro al archivo logback.xml de su agente privado:
```
<logger name="org.jitterbit.connector.openai" level="DEBUG"/>
```
Para más información sobre el registro detallado del conector, consulte Registro detallado para conectores que utilizan agentes privados de Jitterbit.
Si se utilizan agentes privados, se pueden consultar los registros de agentes para obtener más información.
Para consideraciones adicionales de solución de problemas, consulte Solución de problemas de operación.

Vívelo en la práctica

Usar OpenAI para procesar datos en una operación de Studio: Construir un prompt a partir de datos de origen, enviarlo a OpenAI y dirigir la respuesta de la IA a un destino posterior.
Procesar documentos con IA: Extraer datos estructurados de documentos no estructurados utilizando el conector de OpenAI.
Dirigir respuestas de LLM a operaciones de Studio utilizando llamadas a funciones: Usar llamadas a funciones de OpenAI para dirigir dinámicamente la salida de LLM a diferentes operaciones de Studio.