Saltar al contenido

Conexión OpenAI en Jitterbit Studio

Introducción

Una conexión OpenAI, creada usando el conector OpenAI, establece acceso a OpenAI. Una vez que se configura una conexión, se pueden crear instancias de actividades OpenAI asociadas a esa conexión para usarlas como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión OpenAI

Se crea una nueva conexión OpenAI usando el conector OpenAI desde una de estas ubicaciones:

Se puede editar una conexión OpenAI existente desde estas ubicaciones:

Configurar una conexión OpenAI

A continuación se describe cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión OpenAI.

Consejo

Los campos con un icono de variable permiten usar variables globales, variables de proyecto y variables Jitterbit. Comienza escribiendo un corchete de apertura [ en el campo o haz clic en el icono de variable para mostrar un menú con las variables existentes disponibles.

  • Connection name: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión OpenAI y no debe contener barras diagonales / ni dos puntos :. Este nombre también se usa para identificar el endpoint OpenAI, que se refiere tanto a una conexión específica como a sus actividades.

  • API/Secret key: Ingresa la clave API. Las claves API se generan en la página API keys de la instancia OpenAI.

  • API version: La versión V1 es la única versión compatible y se selecciona de forma predeterminada.

  • Use Proxy Settings (Private Agent Only): Al usar un agente privado, se puede seleccionar esta configuración para usar configuración de proxy del agente privado para proxy HTTPS. Este conector no admite proxy NTLM.

  • Optional settings: Haz clic para expandir configuraciones opcionales adicionales:

    • Organization ID: Ingresa el ID de organización para la instancia OpenAI. Tu Organization ID se encuentra en la página Organization Settings.

    • Store chat context across operations (V2 activities only): Haz clic para habilitar la memoria a corto plazo que almacena el contexto del chat más allá del alcance de una sola operación.

      Importante

      Habilitar esta configuración almacena el contexto del chat en cadenas de operaciones solo para grupos de agentes en la nube. Los agentes privados siempre almacenan el contexto del chat en memoria para operaciones dentro de la misma cadena de operaciones que comparten el mismo chatId, independientemente de esta configuración.

      Cuando se habilita, se muestran estas configuraciones adicionales:

      • Chat context TTL: Ingresa el tiempo de retención del contexto del chat en la memoria a corto plazo en segundos. El valor predeterminado es 86400 segundos (1 día).

  • Máximo de mensajes guardados en contexto: Ingresa el número máximo de mensajes para guardar en el contexto de chat de la memoria a corto plazo. El valor predeterminado y mínimo es 10 mensajes.

  • Cuando no se encuentra el contexto de chat: Selecciona la acción a realizar si no se encuentra el contexto de chat en la memoria a corto plazo:

    • Crear un nuevo contexto: (Predeterminado.) Se crea un nuevo contexto de chat.

    • Fallar la solicitud: La solicitud falla.

  • Probar: Haz clic para verificar la conexión usando la configuración proporcionada. Cuando se prueba la conexión, el agente o los agentes en el grupo de agentes asociado al entorno actual descargan la versión más reciente del conector. Este conector admite suspender la descarga de la versión más reciente del conector mediante la política organizacional Deshabilitar actualización automática del conector.

  • Guardar: Haz clic para guardar y cerrar la configuración de conexión.

  • Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haz clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulta Dependencias de componentes, eliminación y remoción). Un mensaje te pide que confirmes que deseas eliminar la conexión.

Próximos pasos

Después de crear una conexión de OpenAI, colocas un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se usen como orígenes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Se puede acceder a las acciones de menú de una conexión y sus tipos de actividad desde el panel del proyecto y la paleta de componentes de diseño. Para obtener más detalles, consulta Menús de acciones en Conceptos básicos del conector.

Estos tipos de actividad están disponibles:

  • Crear transcripción: Transcribe audio a texto según el idioma de entrada detectado en OpenAI y está diseñado para usarse como destino en una operación.

  • Registrar herramientas (Deprecated): Agrega herramientas a un asistente en OpenAI y está diseñado para usarse como destino en una operación.

    Advertencia

    La actividad Registrar herramientas (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 Registrar herramientas 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.

  • Crear imagen: Crea imágenes basadas en un indicador especificado en OpenAI y está diseñado para usarse como destino en una operación.

  • Prompt V2: Crea una respuesta para el indicador proporcionado usando la API de respuestas de OpenAI y está diseñado para usarse como destino en una operación.

  • Registrar herramientas V2: Agrega herramientas a un asistente usando la API de respuestas de OpenAI y está diseñado para usarse como destino en una operación.

  • Registrar herramientas del servidor MCP: Registra un servidor MCP remoto como proveedor de herramientas con OpenAI y está diseñado para usarse como destino en una operación.

  • Prompt (Deprecated): Crea una finalización de texto para el prompt proporcionado en OpenAI y está diseñado para usarse 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 Prompt V2 rediseñada, 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.

  • Create Translation: Traduce archivos de audio a texto en inglés en OpenAI y está diseñado para usarse como destino en una operación.