Saltar al contenido principal

Azure AI Completion

Sigue estos pasos para configurar un agente utilizando Azure AI Completion.

Paso 1: Obtener la API Key y el Endpoint en Azure OpenAI Playground​

  • Visita: https://oai.azure.com/portal (O accede al portal de Azure, navega hasta tu recurso de Azure OpenAI y haz clic en Playground en el menú lateral).

Paso 2: Abrir la configuración del Playground​

  • En la esquina superior derecha del Playground, haz clic en el botón View Code.
  • Se abrirá un panel que muestra cómo consumir el modelo actual mediante la API.

AI Agent in Elements Menu

Paso 3: Obtener el Endpoint y la API Key​

Los campos Endpoint y Key representan las credenciales utilizadas para autenticar las solicitudes a Azure OpenAI.

En el panel View Code, localiza los siguientes valores:

  • Endpoint: La URL completa que utiliza tu aplicación para enviar solicitudes al modelo, incluyendo el nombre del despliegue (deployment) y la versión de la API.

  • Key: La clave API privada utilizada para autorizar las solicitudes.

Ejemplo de Endpoint para Completions​

Sustituye <your-resource-name> y <deployment-id> por los valores correspondientes:

https://<your-resource-name>.openai.azure.com/openai/deployments/<deployment-id>/completions?api-version=2023-05-15

Paso 4: Identificar el Deployment Name​

  • En la parte superior del Playground, consulta el menú desplegable Model.
  • El valor seleccionado corresponde a tu Deployment ID (por ejemplo, gpt-35-turbo).
  • Este nombre debe coincidir con el deployment utilizado en el Endpoint.

Paso 5: Integrar tu agente de Azure AI con XR Creator Studio​

Una vez que hayas obtenido tu Endpoint y tu API Key, podrás integrar el agente en tu proyecto de XR.

1. Agregar un elemento 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 configurar los parámetros necesarios para conectar tu agente con Azure AI.

AI Agent Properties Panel

  • Agent Name: Nombre que aparecerá en la interfaz de chat.
  • Provider: Selecciona Azure AI Completion.
  • System Prompt: Define las instrucciones que describen el comportamiento, la personalidad o las restricciones del agente (por ejemplo: "Eres un asistente especializado en los productos de la empresa"). Este campo es opcional y admite hasta 4,000 caracteres.
  • Memory: Define el tipo de memoria que utilizará el agente.
    • Temporary (Volatile): El agente conserva el historial de conversación únicamente durante la sesión actual. Al abandonar la experiencia, el historial se elimina.
    • Persistable: Permite conservar el historial de conversación entre sesiones. Consulta la sección Enable Persistable Memory for Completion Agents para más información.
  • API Key: Introduce de forma segura tu clave API secreta.
  • Endpoint: (Obligatorio para Azure AI Completion) Introduce la URL del Endpoint de tu despliegue de Azure OpenAI. Puedes encontrarla en el Playground.
  • Voice Options:
    • WebAPI – Utiliza la función de texto a voz del navegador (puede variar según el navegador).
    • Silent – El agente solo se comunicará mediante chat de texto.
  • Observable (Emit Events): Activa esta opción para que el agente pueda emitir eventos utilizados por scripts dentro de la experiencia. Esta función es especialmente útil cuando se trabaja 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.
      • 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 API Key y Endpoint. Una vez configuradas estas propiedades, podrás publicar tu proyecto y disponer de un AI Agent completamente funcional.

Habilitar memoria persistente para agentes de Completion​

Puedes habilitar la memoria persistente para que el agente conserve el historial de conversación entre diferentes sesiones.

Para ello, selecciona un elemento Persistable desde el menú de elementos. Este se añadirá automáticamente al panel de jerarquía.

AI Agent in Elements Menu

A continuación, en las propiedades del agente, selecciona el elemento Persistable recién creado desde el menú desplegable y publica el Verse.

AI Agent in Elements Menu

Esto permitirá que el agente conserve el contexto y el historial de las conversaciones entre sesiones.