Actividad Azure OpenAI Prompt en Jitterbit Studio

Introducción

Una actividad Prompt de Azure OpenAI, utilizando su conexión de Azure OpenAI, crea una finalización de texto para el prompt proporcionado en Azure OpenAI y está diseñada para usarse como destino para consumir datos en una operación.

Crear una actividad Azure OpenAI Prompt

Se crea una instancia de una actividad Prompt de Azure OpenAI a partir de una conexión de Azure OpenAI utilizando su tipo de actividad Prompt.

Para crear una instancia de una actividad, arrastra el tipo de actividad al lienzo de diseño o copia el tipo de actividad y pégalo en el lienzo de diseño. Para más detalles, consulta Crear una instancia de actividad o herramienta en Reutilización de componentes.

Se puede editar una actividad Prompt de Azure OpenAI existente desde estas ubicaciones:

• El lienzo de diseño (consulta Menú de acciones de componentes en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (consulta Menú de acciones de componentes en Pestaña Componentes del panel del proyecto).

Configurar una actividad Azure OpenAI Prompt

Sigue estos pasos para configurar una actividad Prompt de Azure OpenAI:

• Paso 1: Ingresa un nombre y especifica la configuración
  Proporciona un nombre para la actividad y especifica el texto del prompt y la configuración opcional.

• Paso 2: Revisa los esquemas de datos
  Se muestran los esquemas de solicitud o respuesta.

Paso 1: Ingresa un nombre y especifica la configuración

En este paso, proporciona un nombre para la actividad y especifica el texto del prompt y la configuración opcional. A continuación se describe cada elemento de la interfaz de usuario de este paso.

• Menú Endpoint: Si tienes varios endpoints del mismo tipo de conector configurados, un menú en la parte superior de la pantalla muestra el nombre del endpoint actual. Haz clic en el menú para cambiar a un endpoint diferente. Para más información, consulta Cambiar el endpoint asignado en Pantallas de configuración.

• Editar endpoint: Aparece al pasar el cursor sobre el nombre del endpoint actual. Haz clic para editar la configuración de conexión del endpoint seleccionado.

• Nombre: Ingresa un nombre para identificar la actividad. El nombre debe ser único para cada actividad Prompt de Azure OpenAI y no debe contener barras diagonales (/) ni dos puntos (:).

• Texto del prompt: Ingresa el prompt para la finalización.

• ID del modelo: Selecciona el modelo a utilizar. Los despliegues de tu instancia de Azure OpenAI rellenan la lista de modelos. Haz clic en Actualizar para actualizar la lista si has desplegado nuevos modelos desde que abriste esta configuración. Los modelos deben desplegarse primero en Azure para aparecer como opciones. Para obtener información sobre cómo desplegar modelos, consulta la documentación de Microsoft.

• Actualizar: Haz clic en Actualizar para restablecer el ID del modelo al valor guardado anteriormente.

• Configuración opcional: Haz clic para expandir la configuración opcional adicional:

  • Rol: Selecciona el tipo de prompt a enviar a Azure OpenAI:

    • Asistente: Selecciona este rol si un asistente creado previamente enviará un prompt a Azure OpenAI. No selecciones este rol sin que un asistente realice la solicitud, ya que puede causar errores.

    • Sistema: (predeterminado) Selecciona este rol para prompts automatizados.

    • Herramienta: Selecciona este rol si un asistente creado previamente enviará un prompt a Azure OpenAI para utilizar una herramienta registrada con la actividad Registrar herramientas. No selecciones este rol sin que un asistente realice la solicitud o sin herramientas registradas, ya que puede causar errores.

      Múltiples llamadas de herramientas concurrentes

      Si Azure OpenAI devuelve un único mensaje de asistente que contiene múltiples llamadas de herramientas (por ejemplo, cuando se llaman varios MCP tools en paralelo), utiliza una instancia de actividad Prompt (configurada con el rol Herramienta) para devolver todas las respuestas de herramientas coincidentes en lugar de crear una instancia de actividad separada para cada llamada de herramienta. Asigna la transformación que alimenta la actividad para que genere una fila por cada llamada de herramienta, con el contenido de cada fila conteniendo la respuesta de esa llamada de herramienta. Cuando se ejecuta la actividad, envía el mensaje de asistente anterior una vez, seguido de la respuesta de cada herramienta en secuencia coincidida por su tool_call_id, utilizando el mismo chatId que el resto de la conversación.

    • Usuario: Este rol simula un prompt de usuario directo a la IA, como si estuviera en una ventana de chat. Selecciona este rol al crear un asistente y proporciona instrucciones en el campo Texto del prompt.

  • Temperatura: Ingresa la temperatura de muestreo. El valor debe ser un decimal entre 0 y 2. No se recomienda utilizar esta configuración con Probabilidad superior. Esta configuración no es compatible con los modelos GPT-5.6 de OpenAI.

  • Tokens máximos: Ingresa el número máximo de tokens a generar para la finalización. El valor predeterminado es 16.

  • Probabilidad superior: Ingresa la probabilidad superior. No se recomienda utilizar esta configuración con Temperatura. Esta configuración no es compatible con los modelos GPT-5.6 de OpenAI.

  • Seleccionar un índice: Selecciona para interactuar con un índice de búsqueda de Azure AI de Microsoft.

    Nota

    Debes seleccionar y configurar la configuración opcional Agregar una fuente de datos en la conexión. De lo contrario, se produce un error al seleccionar esta opción.

    Cuando se selecciona, aparecen estos campos adicionales:

    • Seleccionar índice de Azure AI Search: Elige un índice de tu servicio de búsqueda de Azure AI. Haz clic en Actualizar para actualizar la lista de índices del servicio de búsqueda de Azure AI.

    • Ingresa el número de resultados de documento superior: Ingresa el número de documentos más relevantes a incluir en el contexto enviado al modelo.

• Seleccionar tipo de búsqueda de Azure Index: Se admite el tipo de búsqueda por palabras clave y se selecciona de forma predeterminada.

• Continuar en caso de error: Selecciona esta opción para continuar la ejecución de la actividad si se encuentra un error en un conjunto de datos en una solicitud por lotes. Si se encuentran errores, se escriben en el registro de operaciones.

• Guardar y salir: Si está habilitado, haz clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haz clic para almacenar temporalmente la configuración de este paso y continuar al siguiente. La configuración no se guardará hasta que hagas clic en el botón Finalizado en el último paso.

• Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Paso 2: Revisar los esquemas de datos

Se muestran los esquemas de solicitud o respuesta. A continuación se describe cada elemento de la interfaz de usuario de este paso.

• Esquemas de datos: Estos esquemas de datos se heredan mediante transformaciones adyacentes y se muestran nuevamente durante el mapeo de transformación.

  Nota

  Los datos suministrados en una transformación tienen prioridad sobre la configuración de la actividad.

  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 y campos del esquema.

• Actualizar: Haz clic en el icono de actualización o en la palabra Actualizar para regenerar esquemas desde el punto de conexión de Azure OpenAI. Esta acción también regenera un esquema en otras ubicaciones del proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

• Editar: Haz clic en el icono de edición encima de cada esquema de datos para acceder al editor de ese esquema de datos. El editor te permite agregar, eliminar y reorganizar nodos y campos, así como cambiar sus tipos de datos. Todos los nodos y campos recién agregados se establecen en [0, 1] cardinalidad. Los cambios realizados en los esquemas de datos deben ser aceptables para el punto de conexión y solo deben realizarse después de consultar la documentación disponible para el punto de conexión. Después de realizar ediciones de esquema, se muestra una fecha de última edición en la parte superior del esquema aplicable para indicar que el esquema ha tenido ediciones manuales. Actualizar los esquemas restablecerá los esquemas a sus estructuras predeterminadas.

• Atrás: Haz clic para almacenar temporalmente la configuración de este paso y volver al paso anterior.

• Finalizado: Haz clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

• Descartar cambios: Después de realizar cambios, haz clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje te pide que confirmes que deseas descartar los cambios.

Próximos pasos

Después de configurar una actividad Prompt de Azure OpenAI, completa la configuración de la operación agregando y configurando otras actividades o herramientas como pasos de la operación. También puedes configurar los parámetros de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en los mismos flujos de trabajo o en flujos de trabajo diferentes.

Las acciones de menú de una actividad son accesibles desde el panel del proyecto y el lienzo de diseño. Para obtener más detalles, consulta Menú de acciones de actividad en Conceptos básicos del conector.

Las actividades Prompt de Azure OpenAI se pueden usar como destino con estos patrones de operación:

• Patrón de transformación
• Patrón de dos transformaciones (como primer o segundo destino)

Para usar la actividad con funciones de scripting, escribe los datos en una ubicación temporal y luego usa esa ubicación temporal en la función de scripting.

Cuando esté listo, implementa y ejecuta la operación y valida el comportamiento verificando los registros de operación.