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 conocen como 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 tu 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.

Importante

Para gestionar el historial de chat, debes estar utilizando un agente privado para mantener el contexto de la conversación entre las llamadas a la API.

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

Este conector soporta las versiones de Azure OpenAI 2024-10-21 y 2025-03-01 preview.

Solución de problemas

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

  1. Haz clic en el botón Probar en la configuración de conexión para asegurarte de que la conexión sea exitosa y de que la última versión del conector se descargue al agente (a menos que estés utilizando la política de organización Desactivar actualización automática del conector).

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

  3. Habilita el registro de depuración de operaciones (para agentes en la nube o para agentes privados) para generar archivos y datos de registro adicionales.

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

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

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

  5. Si utilizas agentes privados, puedes revisar los registros del agente para más información.

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