Saltar al contenido

Conector de Azure OpenAI para 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.

El conector de Azure 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 primero para configurar una conexión de Azure 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 Azure OpenAI y sus actividades se denominan un punto final de Azure OpenAI:

Tipos de actividades de Azure OpenAI

  • Registrar herramientas: Agrega herramientas a un asistente de chatbot en Azure OpenAI y está destinado a ser utilizado como un destino en una operación.

  • Solicitar imagen: Genera una imagen basada en un aviso especificado en Azure OpenAI y está destinado a ser utilizado como un destino en una operación.

  • Aviso: Crea una finalización de texto para el aviso proporcionado en Azure OpenAI y está destinado a ser utilizado como un destino en una operación.

  • Descargar imagen (obsoleto): Recupera la URL de una imagen generada previamente de Azure OpenAI y está destinado a ser utilizado como una fuente 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 reportes de uso de puntos finales y cuentan para su licencia.

Prerrequisitos y versiones de API soportadas

El conector de Azure 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.

Nota

El conector utiliza la Chat Completion API para todos los modelos excepto gpt-35-turbo-instruct, que utiliza la Completions API heredada. Este cambio refleja las jubilaciones de modelos en curso de Microsoft. Para más información, consulte jubilaciones de modelos de Azure OpenAI.

Consejo

Siga estas pautas para gestionar el historial de chat a través de las operaciones:

  • Grupos de agentes en la nube: Habilite la opción Almacenar contexto de chat a través de 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 de Registro de 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 Azure OpenAI Service REST API. Consulte la documentación de la API para obtener información sobre los nodos y campos del esquema.

El conector recupera la lista de modelos disponibles de su recurso de Azure OpenAI cuando configura una actividad. Solo los modelos desplegados en su recurso de Azure OpenAI aparecerán en el menú de selección de ID de modelo. Para obtener información sobre cómo desplegar modelos, consulte la documentación de Microsoft.

Solución de problemas

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

  1. 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 esté utilizando la política de organización Deshabilitar actualización automática del conector).

  2. Revise los registros de operaciones para cualquier información escrita durante la ejecución de la operación.

  3. 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.

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

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

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

  5. Si utiliza agentes privados, puede consultar los registros del agente para obtener más información.

  6. Para consideraciones adicionales de solución de problemas, consulte Solución de problemas de operaciones.