Saltar al contenido

Conectar un agente de IA a Jitterbit App Builder

Descripción general

Esta guía muestra cómo conectar App Builder a un agente de IA de Jitterbit a través de una fuente de datos REST API. Este es el primer paso para configurar la funcionalidad de IA Conversacional.

La conexión implica crear un servidor de fuente de datos REST, configurar un endpoint para el agente de IA y asignar los tipos de uso de columnas que la IA Conversacional requiere para identificar los campos de solicitud y respuesta.

Crear un servidor de fuente de datos REST

  1. Inicia sesión en tu instancia de App Builder.

  2. Accede al IDE.

  3. En Conectar, haz clic en Servidores de Datos.

  4. Haz clic en + Servidor. Se abre el diálogo de Configuración del Servidor.

  5. Configura el servidor:

    Configuración del servidor

    • Nombre del Servidor: Ingresa un nombre descriptivo para el servidor.

    • Tipo: Selecciona REST API.

    • URL: Ingresa la URL base del endpoint REST API de tu agente de IA.

    • Tipo de Contenido de Solicitud y Tipo de Contenido de Respuesta: Selecciona JSON.

  6. Haz clic en Guardar, luego cierra el diálogo.

Importante

Solo los usuarios que pertenezcan a un grupo con acceso a esta fuente de datos podrán ver y usar la IA Conversacional.

Configurar el endpoint

  1. En la lista de Servidores de Datos, selecciona el nuevo servidor que acabas de crear. Haz clic en el ícono para ver más detalles y haz clic en el botón Endpoints.

  2. (Opcional) En el panel de Parámetros del Servicio Web, agrega cualquier parámetro requerido para todos los endpoints, como parámetros de encabezado para la autenticación de la API. Haz clic en + Parámetro, completa los campos y luego haz clic en el ícono para guardar.

  3. En el panel de Endpoints, haz clic en + Endpoint. Aparece una nueva fila.

  4. Configura el endpoint:

    • Nombre: Ingresa un nombre descriptivo.

    • Endpoint: Ingresa la ruta del endpoint del agente de IA.

    • Method: Selecciona el método HTTP (típicamente POST).

  5. Haz clic en el ícono para guardar el endpoint.

  6. En el panel de Parámetros del Endpoint, agrega parámetros para la interacción del agente. Hay dos formas de hacerlo:

    • Creación manual: Haz clic en + Parámetro para agregar manualmente parámetros del endpoint. Se abre el siguiente diálogo:

      Diálogo de parámetros del endpoint

      Después de agregar todos los parámetros, regresa al panel de Endpoints y haz clic en Probar Conexión para verificar que la conexión funcione. Luego, haz clic en Descubrir y, en el diálogo, haz clic en Descubrir para importar el esquema de la API. El esquema importado aparece en el panel de Resultados SQL.

    • Autocompletar: Para endpoints POST, puedes hacer clic en el botón Descubrir en el panel de Endpoints primero. En el diálogo que se abre, ingresa un cuerpo de solicitud JSON de ejemplo en el campo Cuerpo de Solicitud, luego haz clic en Descubrir.

      Descubrir parámetros del endpoint

      Haz clic en Descubrir. El panel de Resultados SQL muestra las tablas para tu API REST, mientras que el panel de Resultados de Texto muestra JSON basado en el cuerpo de solicitud que ingresaste.

  7. En el panel de Resultados SQL, haz clic en el ícono para cada tabla que fue importada. Se abre la página de definición de la tabla, donde puedes configurar los tipos de uso de las columnas. La IA Conversacional requiere tipos de uso de columna específicos para identificar qué parámetros llevan el mensaje del usuario y la respuesta del agente. Los siguientes tipos de uso están disponibles:

    Tipo de Uso Descripción
    Sugerencia del Agente El parámetro que lleva el mensaje del usuario al agente.
    Respuesta del Agente El parámetro que lleva la respuesta del agente al usuario.
    Usuario del Agente - ID de Usuario (Opcional) Un parámetro que identifica al usuario actual por ID.
    Usuario del Agente - Correo Electrónico (Opcional) Un parámetro que identifica al usuario actual por dirección de correo electrónico.
    Usuario del Agente - Nombre de Usuario (Opcional) Un parámetro que identifica al usuario actual por nombre de usuario.
    Sesión del Agente (Opcional) Un parámetro que lleva el ID de la sesión de chat actual.

    Consejo

    Para los agentes de IA del Jitterbit Marketplace, la columna que contiene el mensaje del usuario generalmente se llama "prompt" (correspondiente al tipo de uso Agent Prompt), y la columna que contiene la respuesta del agente generalmente se llama "message" (correspondiente al tipo de uso Agent Response). Consulta la documentación específica de tu agente para conocer los nombres exactos de los campos.

    Para cada columna que corresponde a un tipo de uso, haz doble clic en la fila de una columna o haz clic en su icono para abrir su configuración, luego establece el campo Column Usage Type en el valor apropiado.

Next steps

Después de conectar tu agente de IA, puedes continuar con los siguientes pasos para configurar la función de IA Conversacional configurando un agente en el IDE. Consulta Configurar un agente para continuar.