1. Conéctese a la cuenta de Oracle Cloud.
2. En la consola de Infrastructure, haga clic en en la parte superior izquierda para abrir el menú de navegación, seleccione Análisis y AI y seleccione Asistente digital (que aparece bajo la categoría Servicios AI de la página).
3. En el panel Compartimentos, seleccione un compartimento.

   Si aún no ha creado un compartimento, consulte Descripción de compartimentos y Gestión de compartimentos.

4. Haga clic en Crear instancia de asistente digital.
5. En la página Crear instancia de Digital Assistant, rellene los siguientes detalles:
   • Compartimento.

   • Nombre. Introduzca un nombre que refleje el uso de la instancia. Por ejemplo, para un entorno de desarrollo, puede utilizar oda-dev1.

   • Unidad de instancia. Seleccione una de las siguientes unidades de computación:

     • Desarrollo. Se trata de una opción ligera orientada al trabajo de desarrollo.
     • Producción. Esta opción se debe seleccionar para las instancias de producción de Digital Assistant. En comparación con la unidad de computación Desarrollo, esta opción tiene unos mayores límites de frecuencia y una mayor capacidad de base de datos, lo que permite recopilar más datos de estadísticas.

     Consulte Unidades de instancia y límites de frecuencia y almacenamiento para obtener información sobre los límites de frecuencia.

   • Si desea activar el acceso basado en roles a la instancia (en lugar del acceso basado en políticas por defecto de IAM), haga clic en Mostrar opciones avanzadas, seleccione Activar acceso basado en roles y seleccione un dominio de identidad.

     Consulte Role-Based Access and Identity Domains para obtener información sobre la configuración de usuarios y grupos y la asignación de roles.

     Nota
     
     La opción Activar acceso basado en roles está desactivada si el arrendamiento actual aún no tiene soporte para dominios de identidad.

   • Espacio de nombres de etiqueta. (Opcional) Para obtener más información sobre este funcionamiento, consulte Gestión de etiquetas y espacios de nombres de etiquetas.

6. Haga clic en Crear.

   Tras unos minutos, la instancia pasará de estado de estado Creando a Activo, lo que significa que la instancia está lista para su uso.

Una vez que haya aprovisionado una instancia, puede acceder a ella desde la consola de Infrastructure siguiendo estos pasos:

1. En la página de la consola de la instancia, haga clic en el botón Consola de servicio.

   Se le redirigirá a otra página de conexión.

2. Haga clic en el enlace Cambiar inquilino.

3. En el campo Inquilino en la nube, introduzca el valor del campo Cuenta en la nube en la sección Detalles de acceso del correo electrónico de bienvenida.

4. Inicie sesión en la instancia.

   Como administrador de inquilinos, siempre puede conectarse con sus credenciales de inicio de sesión (en la parte izquierda de la página).

   Los usuarios aprovisionados con cuentas de usuario de IAM pueden conectarse en el extremo correcto.

   Una vez que se haya conectado, debe dirigirse a su instancia de servicio de Oracle Digital Assistant.

   Nota
   
   Si la nueva contraseña no funciona, puede deberse a que aún no haya tenido efecto. Si este es el caso, intente introducir la contraseña temporal que recibió en el correo electrónico de bienvenida.

Puede recuperar la dirección URL para la instancia de servicio en la página de la consola para la instancia. En ese caso, tendrá que compartir esa URL con su equipo, ya que no se le notificará de otra forma, incluso cuando se les otorguen permisos para Digital Assistant.

1. En el separador Información de instancia, haga clic en el enlace Copiar que aparece a la derecha del campo URL de web de base.

   De esta forma se copiará la URL en el portapapeles del sistema.

2. Pegue la URL en una ubicación adecuada.

3. Comparta esta URL con los miembros de su equipo.

Oracle Digital Assistant tiene límites para el número de instancias y servicios de componentes personalizados embebidos que puede crear. Cuando se crea una nueva instancia o un servicio de componentes personalizados embebidos, el sistema garantiza que la solicitud esté dentro de los límites de su límite.

Para las instancias, el límite depende del tipo de solitud de Digital Assistant que haya realizado:

Puede utilizar las cuotas para determinar de qué modo otros usuarios asignan los recursos entre compartimentos en Oracle Cloud Infrastructure. Cuando se crea una instancia de Oracle Digital Assistant o se amplía, el sistema garantiza que la solicitud esté dentro de los límites de la cuota para ese compartimento.

Para obtener más información sobre cómo funcionan las cuotas, consulte Cuotas de compartimento.

En esta tabla se muestra la cuota relacionada con Digital Assistant que puede aplicar a los compartimentos

El número de solicitudes por minuto que se pueden realizar en la instancia depende de la unidad de la instancia:

• Unidad de desarrollo: 50 solicitudes por minuto
• Unidad de producción: 500 solicitudes por minuto

Estos límites incluyen las solicitudes desde canales de usuario (como Slack, Microsoft Teams, Web, Twilio, Webhook, etc.).

Para las solicitudes que se produzcan cuando se alcanza el límite de frecuencia, se devuelve una respuesta HTTP 429 (demasiadas solicitudes).

Además, la cantidad de almacenamiento asignada a los datos de Insights depende de la unidad de instancia:

• Unidad de desarrollo: 40 GB
• Unidad de producción: 100GB

Al configurar la instancia para los usuarios, debe planificar cuidadosamente cómo organiza el arrendamiento y construir los grupos de usuarios y las políticas. Sin embargo, si desea configurar rápidamente una instancia antes de familiarizarse completamente con estos conceptos, puede seguir la "receta" siguiente.

En esta receta, además de aprovisionar la instancia, puede configurar permisos para desarrolladores y administradores mediante el servicio Identity and Access Management (IAM) de Oracle Cloud Infrastructure. Más tarde, puede adaptar la receta a sus propias necesidades.

1. Cree un compartimento en el que colocará la instancia.

   Los compartimentos proporcionan agrupaciones lógicas de instancias de servicio y otros recursos en la nube. Al crear un compartimento para la instancia, puede otorgar permisos a los usuarios para la instancia sin otorgar esos permisos para todo el arrendamiento.

   1. En la consola de Infrastructure, haga clic en en la esquina superior izquierda para abrir el menú de navegación, seleccione Identidad y seguridad y seleccione Compartimentos.

   2. Haga clic en Crear compartimento.
   3. En el campo Nombre, introduzca da_development.

      Si lo desea, puede elegir otro nombre. Si lo hace, recuerde ajustar las definiciones de política a continuación como corresponda.

   4. Rellene el resto de los valores necesarios y haga clic en Crear compartimento.

2. Cree cuentas de usuario de IAM para otros miembros del equipo que desee que tengan acceso a la instancia.

   1. En la sección Identidad de la página Identidad y seguridad, haga clic en Usuarios.

   2. Haga clic en Crear usuario.

   3. En el cuadro de diálogo Crear usuario, rellene los detalles necesarios con especial atención a lo siguiente:

      • El valor de Nombre puede ser una dirección de correo electrónico o un nombre único. Será el nombre que el usuario usa para conectarse a la instancia.
      • Valor de Correo electrónico, que se utiliza para la recuperación de la contraseña.

   4. Haga clic en Crear.

   5. Una vez creado el usuario, seleccione el usuario y haga clic en Crear/Restablecer contraseña.

   6. Haga clic Copiar.

   7. Pegue la contraseña en un lugar seguro y, a continuación, proporciónela al usuario.

      El usuario deberá conectarse con esa contraseña y, a continuación, cambiarla inmediatamente.

3. Cree un grupo de IAM para los desarrolladores y uno para los administradores.

   1. En la sección Identidad de la página Identidad y seguridad, haga clic en Grupos.

   2. Haga clic en Crear grupo.

   3. Complete los campos del cuadro de diálogo como se indica a continuación:

      • Nombre: ServiceDevelopers
      • Descripción: Developer access to the instance of Digital Assistant in the da_development compartment.

   4. Haga clic en Crear grupo para completar la creación del grupo.

   5. De nuevo, haga clic en el botón Crear grupo de la página.

   6. Introduzca lo siguiente:

      • Nombre: ServiceAdministrators
      • Descripción: Complete access to the instance of Digital Assistant in the da_development compartment, including the ability to set feature flags and purge data.

   7. Haga clic en Crear grupo.

   Nota
   
   Al igual que con el nombre del compartimento, puede asignar a los grupos el nombre que desee. Si utiliza nombres diferentes, recuerde ajustar las definiciones de política que aparecen a continuación como corresponda.

4. Cree políticas para cada grupo que defina el nivel de acceso que obtiene cada miembro a la instancia de Digital Assistant.

   En estos pasos, creará políticas para definir el acceso que tendrá cada grupo. Para el grupo de desarrolladores, otorgará permisos que permitan el desarrollo de aptitudes y asistentes digitales, la creación de canales y otras funciones útiles para los desarrolladores. Para el grupo de administradores, otorgará permisos completos para la instancia, incluida la capacidad de activar funciones y gestionar datos de análisis.

   1. En la sección Identidad de la página Identidad y seguridad, haga clic en Políticas.

   2. En la lista de compartimentos de la izquierda, seleccione da_development.

   3. Haga clic en Crear política.

   4. En Nombre y Descripción, introduzca lo siguiente:

      • Nombre: Policy-for-DA-ServiceDevelopers
      • Descripción: Policy for developer access to instances of Digital Assistant in the da_development compartment.

   5. En Control de versiones de política, seleccione Mantener política actualizada.

   6. En Sentencia, introduzca las siguientes dos sentencias:

      • Allow group ServiceDevelopers to use oda-design in compartment da_development
      • Allow group ServiceDevelopers to use oda-insights in compartment da_development

   7. Haga clic en Crear.

   8. De nuevo, haga clic en Crear política.

   9. Introduzca lo siguiente:

      • Nombre: Policy-for-DA-ServiceAdministrators
      • Descripción: Policy for complete access to instances of Digital Assistant in the da_development compartment.
      • Control de versiones de política: Mantener política actualizada.
      • Sentencia: Allow group ServiceAdministrators to manage oda-family in compartment da_development

   10. Haga clic en Crear.

5. Agregue usuarios a los grupos de IAM adecuados. (No es necesario que se agregue a sí mismo, ya que dispone de acceso a la instancia como administrador de cuentas en la nube).

   1. En el menú Identidad, seleccione Grupos.

   2. Localice el grupo en la lista.

   3. Haga clic en el grupo.

   4. Haga clic en Agregar usuario a grupo.

   5. Seleccione el usuario en la lista desplegable y, a continuación, haga clic en Agregar usuario.

6. Cree la instancia de servicio de Oracle Digital Assistant.

   1. Haga clic en en la parte superior izquierda para abrir el menú de navegación, seleccione Análisis e IA y seleccione Asistente digital.

   2. En el panel Compartimentos, seleccione da_development.
   3. Haga clic en Crear instancia.
   4. En la página Crear instancia, rellene los siguientes detalles:
      • Compartimento: da_development

      • Nombre: da-dev1 (u otro nombre que refleje el uso de la instancia)

      • Unidad de instancia:

        • Desarrollo. Se trata de una opción ligera orientada al trabajo de desarrollo.
        • Producción. Esta opción se debe seleccionar para las instancias de producción de Oracle Digital Assistant. En comparación con la unidad de desarrollo, la unidad de producción puede aceptar más solicitudes por minuto y tiene una mayor capacidad de base de datos, lo que permite recopilar y almacenar más datos de estadísticas.
   5. Active la casilla de control VER DETALLES DE INSTANCIA DE ASISTENTE DIGITAL DESPUÉS DE CREAR.
   6. Haga clic en Crear.

      Tras unos minutos, la instancia pasará de estado de estado Creando a Activo, lo que significa que la instancia está lista para su uso.

7. Obtenga la URL para los usuarios.

   1. En el separador Información de instancia de la página para la instancia en la consola de Infrastructure , haga clic en el enlace Copiar que aparece a la derecha del campo URL de web de base.

      De esta forma se copiará la URL en el portapapeles del sistema.

   2. Pegue la URL en una ubicación adecuada.

   3. Comparta esta URL con los miembros de su equipo.

      Puesto que las ha configurado con cuentas de IAM, pídales que se conecten en el lado derecho de la página de conexión (en Oracle Cloud Infrastructure).

      Sin embargo,deberá conectarse en el lado izquierdo de la página con su cuenta de SSO (a menos que haya agregado su cuenta de usuario de IAM al grupo ServiceDevelopers o ServiceAdministrator).

      Nota
      
      Como administrador de cuentas en la nube, dispone de cuentas de SSO (a través de Oracle Identity Cloud Service) y de cuentas de IAM. Y, como administrador de cuentas en la nube, puede conectarse a Digital Assistant con su cuenta de SSO sin tener que agregarse primero a un grupo con permisos para Digital Assistant.

8. (Opcional) Acceda a la instancia desde la consola de Infraestructura.

   También puede acceder a la instancia de servicio desde la consola de Infraestructura:

   1. En la página de la consola de la instancia, haga clic en el botón Consola de servicio.

      Se le redirigirá a otra página de conexión.

   2. En la página de conexión, en Conexión al inquilino en la nube, asegúrese de que el nombre del inquilino coincida con el nombre del campo Cuenta en la nube en la sección Detalles de acceso del correo electrónico de bienvenida. De lo contrario, haga clic en el enlace Cambiar inquilino e introduzca el nombre de su cuenta en la nube antes de continuar.

   3. En el lado izquierdo de la página, en Single Sign-On (SSO), haga clic en Continuar.

      Se le dirigirá a la instancia de servicio de Oracle Digital Assistant.

Las instancias de Digital Assistant que se combinan con suscripciones a un servicio de Oracle Fusion Applications Cloud están diseñadas para que utilice y amplíe las aptitudes existentes listas para usar que proporciona ese servicio de Fusion Applications. Por defecto, estas instancias emparejadas no permiten utilizar todo el rango de funciones de Digital Assistant, como la creación y clonación de aptitudes y asistentes digitales.

Si desea aprovechar el rango completo de funciones de Digital Assistant dentro de la instancia asociada, puede enlazar esa instancia asociada a una suscripción a Digital Assistant como servicio individual. Si la instancia emparejada no está enlazada de esta forma, recibirá mensajes de advertencia al crear aptitudes o asistentes digitales o al realizar cualquier otra tarea que no esté cubierta por los términos de la instancia emparejada.

Hay dos formas de enlazar la instancia de Digital Assistant emparejada:

• Con la misma cuenta de Oracle Cloud en la que tiene su suscripción a Fusion Applications, compre una suscripción a Oracle Digital Assistant Platform for SaaS. Una vez que haya activado el derecho para esa suscripción, el enlace se debe establecer automáticamente.

  Sabrá que el enlace se ha establecido correctamente si puede hacer cosas en la instancia emparejada como crear nuevas aptitudes sin ver una advertencia de que no tiene el derecho necesario para hacerlo.

  Nota
  
  Al enlazar a este tipo de suscripción, no necesita realmente aprovisionar una nueva instancia para que funcione el enlace. De hecho, es mejor seguir realizando su trabajo de desarrollo en la instancia emparejada y no aprovisionar una instancia para la suscripción a Oracle Digital Assistant Platform for SaaS.

• Utilizando la misma cuenta de Oracle Cloud en la que tiene su suscripción a Oracle Applications, suscríbase a Digital Assistant Cloud Service mediante el programa Créditos universales, aprovisione una instancia y, a continuación, enlace manualmente esa instancia a su instancia emparejada. Consulte Enlace manual de instancias de Digital Assistant.

Cada instancia de Digital Assistant que se migró de la infraestructura de Gen 1 a la infraestructura de Gen 2 tiene una aplicación de dominio de identidad de OCI IAM para gestionar la autorización de usuario y el acceso a las API.

Dentro de esa aplicación de dominio de identidad hay un grupo denominado OCI_Administrators. El administrador de la cuenta de Cloud está asignado a este grupo. Los miembros de este grupo pueden acceder a la consola de infraestructura para aprovisionar nuevas instancias y gestionar usuarios.

A continuación, se muestran algunas diferencias que debe tener en cuenta (y posiblemente realizar alguna acción al respecto) una vez que se ha migrado una instancia de Gen 1 a Gen 2:

• Hay dos nuevos roles de aplicación disponibles en la aplicación de dominio de identidad de OCI IAM de la instancia (ServiceAdmin y ServiceBusinessUser), además de ServiceDeveloper, que era el único rol disponible en las instancias de Gen 1.

• Los paquetes de componentes personalizados que cargue en un servicio de componentes personalizados embebidos deben contener todas las dependencias de módulos de nodo, como se describe en Preparación del paquete para un servicio de contenedor embebido. Si el paquete no contiene todas sus dependencias, recibirá un error de ruta de acceso de componente no válida.

• En la infraestructura Gen 2, hay límites de servicio para los servicios de componentes personalizados embebidos.

  Si necesita incrementar el límite, puede solicitar un aumento. Para obtener más información, consulte Visualización de los límites de servicio en la consola de Infrastructure y Solicitud de aumento del límite de servicio.

• Si alguna de sus aptitudes utiliza el componente OAuth2Client para acceder a las API de REST de Oracle Digital Assistant, el servicio de autenticación en el que se basan debe actualizar para utilizar la nueva aplicación confidencial de OCI IAM que se ha aprovisionado para la instancia de Gen 2. Deberá actualizar el identificador de cliente, el secreto de cliente y el ámbito. Para obtener más información sobre cómo obtener los nuevos valores, consulte el tema Envío de solicitudes en API de REST para Oracle Digital Assistant en Oracle Cloud Infrastructure. Para obtener información sobre la actualización del servicio de autenticación, consulte Servicios de autenticación.

• El punto final de la API de sesiones ha cambiado y ahora incluye el identificador de usuario y el identificador de canal, además del identificador de sesión. Para cualquier componente personalizado que llame a esta API para obtener el log de conversación, debe modificar esa llamada a la API. Además, se debe actualizar el identificador de cliente, el secreto de cliente y el ámbito que utiliza para obtener el token de acceso para autorizar la llamada de REST. Para los componentes personalizados que acceden a la API de sesiones, debe realizar los siguientes cambios:

  • El código debe llamar a conversation.channelId() para obtener el identificador de canal para la ruta de solicitud.
  • Debe cambiar la ruta de solicitud a /api/v1/bots/sessions/{channelId}/{userId}/{sessionId}/log. Tenga en cuenta que actualmente, el identificador de usuario tiene el mismo valor que el identificador de sesión.
  • Si el componente personalizado recupera el token de acceso, el identificador de cliente, el secreto de cliente y el ámbito se deben actualizar en la llamada de REST al punto final del token de acceso. Para obtener más información sobre cómo obtener los nuevos valores, consulte el tema Envío de solicitudes en API de REST para Oracle Digital Assistant en Oracle Cloud Infrastructure.

  Una vez realizados los cambios, vuelva a empaquetar los componentes. A continuación, para todas las aptitudes que tienen un servicio de componente para el paquete de componentes, vuelva a cargar el paquete.

  Para obtener más información sobre la API, consulte API de REST para Oracle Digital Assistant en Oracle Cloud Infrastructure.

• Para la transferencia de agente (integraciones de agente), la estructura de objeto customInfo es diferente para los nuevos canales si la versión de OSvC de destino es la 19A o posterior.

• Los tipos de canal del SDK para web, Android e iOS en instancias de Gen 1 se sustituyen por versiones nativas de Oracle de esos tipos de canal en Gen 2 (con nuevos SDK para cada tipo de canal). Si tiene aptitudes o asistentes digitales que utilizan los tipos de canal antiguos, debe migrarlos para utilizar los nuevos tipos de canal nativo de Oracle.

  Consulte Ejemplos de personalización y programación de SDK para web de Oracle Digital Assistant en el blog TechExchange para obtener ejemplos concretos de cómo adaptar el código de aplicación web al nuevo SDK para web.

• Ahora puede utilizar Intenciones de respuesta para agregar la funcionalidad de preguntas frecuentes a una aptitud. A diferencia de la funcionalidad Preguntas y respuestas, las intenciones de respuesta se resuelven con NLP. Además, no necesita actualizar el flujo de diálogo para gestionar las intenciones de respuesta del mismo modo que un módulo de preguntas y respuestas.

• Hay una serie de funciones y mejoras disponibles en las instancias de Gen 2 de Digital Assistant que no están disponibles en las instancias de Gen 1. Para obtener un resumen de estas funciones, consulte Novedades de Oracle Digital Assistant.

Para las instancias de Digital Assistant que se han migrado de la infraestructura en la nube Gen 1 a Gen 2, utilice una aplicación de dominio de identidad de OCI IAM para gestionar el acceso a Digital Assistant.

En las instancias de Gen 2, están disponibles los siguientes roles de aplicación:

• ServiceAdministrator, que proporciona permisos completos para la instancia. En las instancias de Gen 1, el rol ServiceDeveloper proporciona este nivel de acceso.
• ServiceDeveloper, que proporciona permisos que son relevantes para los usuarios que desarrollan aptitudes y asistentes digitales. Carece de algunos permisos de administrador (como la capacidad de depurar datos).
• ServiceBusinessUser, que proporciona un subjuego de permisos de ServiceDeveloper y se centra principalmente en la capacidad de trabajar con informes de Insights.

Por defecto, a todos los usuarios de una instancia migrada se les asigna el rol ServiceAdministrator. Para los usuarios que no deben disponer de permisos completos de ServiceAdministrator, puede cambiar los roles que mejor se ajusten al uso que hacen de la instancia.

Dado que Oracle Cloud Infrastructure (Gen 2) es una arquitectura de varios inquilinos, las instancias de Digital Assistant que se migran a Gen 2 no tienen su propio rango de direcciones IP. En su lugar, tiene un rango de direcciones IP públicas determinadas por la región en la que reside la instancia. Si anteriormente tenía una lista de permitidos con un rango de direcciones IP para la instancia cuando estaba en la infraestructura Gen 1, necesitará actualizar esa lista con las direcciones IP públicas proporcionadas en la infraestructura Gen 2.

Para determinar el rango de direcciones IP de la región, consulte Direcciones IP públicas para las VCN y Oracle Services Network.