Saltar al contenido

Conector de Azure OpenAI en Jitterbit Studio

Resumen

El conector de Azure OpenAI establece acceso a Azure OpenAI.

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

Se accede al conector de Azure OpenAI desde la pestaña Puntos finales y conectores del proyecto de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).

Descripción general del conector

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

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

Tipos de actividades de Azure OpenAI

  • Registrar herramientas: Agrega herramientas a un asistente en Azure OpenAI y se pretende utilizar como destino en una operación.

  • Solicitar imagen: Genera una imagen basada en un mensaje especificado en Azure OpenAI y se pretende utilizar como destino en una operación.

  • Mensaje: Crea una finalización de texto para el mensaje proporcionado en Azure OpenAI y se pretende utilizar como destino en una operación.

  • Descargar imagen (obsoleto): Recupera la URL de una imagen generada anteriormente desde Azure OpenAI y se pretende utilizar como origen en una operación.

Los puntos finales creados con este conector se incluyen en informes de uso de puntos finales y cuentan para tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede utilizar 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 Deshabilitar actualización automática de conectores.

Nota

El conector utiliza la API de finalización de chat para todos los modelos excepto gpt-35-turbo-instruct, que utiliza la API de finalizaciones heredada. Este cambio refleja los retiros de modelos continuos de Microsoft. Para obtener más información, consulta Retiros de modelos de Azure OpenAI.

Consejo

Sigue estas directrices para administrar el historial de chat entre operaciones:

  • Grupos de agentes en la nube: Habilita la opción Almacenar contexto de chat entre operaciones en la configuración de conexión. El conector mantiene el contexto de conversación entre operaciones dentro del mismo entorno utilizando el mismo chatId (configurado en la actividad Registrar herramientas).

  • Agentes privados: El contexto de chat se mantiene en la memoria local para operaciones dentro de la misma cadena de operaciones que comparten el mismo chatId.

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

El conector recupera la lista de modelos disponibles de tu recurso de Azure OpenAI cuando configuras una actividad. Solo los modelos implementados en tu recurso de Azure OpenAI aparecerán en el menú de selección de Model ID. Para obtener información sobre cómo implementar modelos, consulta la documentación de Microsoft.

Solución de problemas

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

  1. Haz clic en el botón Test 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 en el agente (a menos que uses la política de organización Disable Auto Connector Update).

  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 utilizas 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.microsoft.azure.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 utilizas 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.