Saltar al contenido principal

OpenAI Assistants

Sigue estos pasos para configurar un asistente en OpenAI que impulse tu agente de IA en el metaverso. Este enfoque te permite cargar archivos para ampliar el conocimiento y el contexto de tu asistente.

1. Crear una cuenta de OpenAI​

2. Generar una clave API de OpenAI​

  1. Accede al Panel de OpenAI.
  2. Dirígete a la sección API Keys.
  3. Haz clic en Create new secret key.
  4. Asigna un nombre, selecciona un proyecto y configura los permisos de seguridad.
  5. Copia y guarda tu clave API en un lugar seguro, ya que no volverá a mostrarse.

Create API Key Button

3. Crear un Assistant​

  1. Abre la página de Assistants.
  2. Haz clic en Create para crear un nuevo Assistant.

Create Assistant

  1. Introduce un nombre y proporciona las instrucciones del sistema (hasta 256,000 caracteres).
  2. Carga los archivos que formarán parte de la base de conocimiento del Assistant.
  3. Activa la herramienta File Search para permitir la búsqueda de información en los archivos cargados.

Enable File Search

  1. Copia el Assistant ID para utilizarlo más adelante. Puedes encontrarlo debajo del nombre de tu Assistant.

Enable File Search

Paso 4: Integrar tu OpenAI Assistant con XR Creator Studio​

Una vez que hayas configurado un Assistant en OpenAI, podrás integrarlo en tu proyecto de XR.

1. Crear un AI Agent en XR Creator​

  1. Abre tu proyecto en el XR Editor.
  2. En el Elements Menu, selecciona AI Agent.

AI Agent in Elements Menu

2. Configurar las propiedades del AI Agent​

En el Properties Panel podrás establecer los parámetros necesarios para conectar tu Assistant.

AI Agent Properties Panel

  • Agent Name: Nombre que aparecerá en la interfaz de chat.
  • Provider: Selecciona el proveedor de IA. En este caso, OpenAI Assistant.
  • OpenAI API Key: Introduce de forma segura tu clave API secreta.
  • Assistant ID: Identificador único (asst_...) del Assistant en OpenAI. Puedes encontrarlo en la página de Assistants.
  • Voice Options:
    • OpenAI – Utiliza la generación de voz de OpenAI.
    • WebAPI – Utiliza la función de texto a voz del navegador (puede variar según el navegador).
    • Silent – El agente solo se comunicará mediante el chat de texto.
  • Observable (Emit Events): Activa esta opción para que el agente pueda emitir eventos que se utilizarán en scripts dentro de la experiencia. Esta función es especialmente útil al trabajar con nuestra Scripting API. Consulta la guía del AI Agent Event System para más información.
  • Enable Proximity: Permite que el agente detecte cuando un usuario entra o sale de un área determinada.
    • Proximity Radius: Define la distancia (en metros/unidades) alrededor del agente en la que se activarán los eventos de proximidad, como la entrada o salida de un usuario.
      • User Prompts: Activa esta opción para que el agente muestre mensajes personalizados cuando un usuario entre o salga de su área de proximidad.
        • User Enter Prompt: Mensaje que el agente mostrará o dirá cuando un usuario entre en el radio de proximidad definido.
        • User Leave Prompt: Mensaje que el agente mostrará o dirá cuando un usuario salga del radio de proximidad definido.

Los únicos campos obligatorios son OpenAI API Key y Assistant ID. Una vez configuradas estas propiedades, podrás publicar tu proyecto y contar con un AI Agent completamente funcional.