A continuación se muestra un ejemplo de cómo puede utilizar la función de búsqueda para ver todas las operaciones de supresión:

1. Haga clic en + Criterios.
2. En el campo Filtro, seleccione Operación.
3. En el campo Operador, seleccione Empieza por.
4. En el campo Valor, introduzca Delete.
5. Haga clic en Buscar.

En los resultados de la búsqueda, verá entradas para cualquier operación con nombres que empiecen por Delete, como DeleteSkill o DeleteSkillIntent.

Estos son los tipos de evento que emiten las instancias del servicio Oracle Digital Assistant:

com.oraclecloud.digitalassistant.changeodacompartment.begin

com.oraclecloud.digitalassistant.changeodacompartment.end

com.oraclecloud.digitalassistant.createodainstance.begin

com.oraclecloud.digitalassistant.createodainstance.end

com.oraclecloud.digitalassistant.deleteodainstance.begin

com.oraclecloud.digitalassistant.deleteodainstance.end

com.oraclecloud.digitalassistant.updateodainstance

Éste es un evento de referencia para las instancias de servicio de Oracle Digital Assistant.

{
  "id": "ocid1.eventschema.oc1.phx.abyhqljrfajridyag4epdbthdjuhwgkwxxog32ed4e36yx2zotmphyxe3z5q",
  "exampleEvent": {
    "eventID": "unique_id",
    "eventTime": "2019-10-09T13:58:03.575Z",
    "contentType": "application/json",
    "eventType": "com.oraclecloud.digitalassistant.createodainstance.end",
    "cloudEventsVersion": "0.1",
    "source": "DigitalAssistant",
    "extensions": {
      "compartmentId": "ocid1.compartment.oc1..unique_ID"
    },
    "eventTypeVersion": "2.0",
    "data": {
      "resourceName": "example_name",
      "compartmentId": "ocid1.compartment.oc1..unique_ID",
      "availabilityDomain": "all",
      "compartmentName": "example_name",
      "resourceId": "ocid1.odainstance.oc1.phx.unique_ID"
    }
  },
  "serviceName": "Digital Assistant",
  "displayName": "ODA Instance - Create End",
  "eventType": "com.oraclecloud.digitalassistant.createodainstance.end",
  "additionalDetails": [],
  "timeCreated": "2019-10-09T13:58:03.575Z"
}

Las métricas de Oracle Digital Assistant se emiten con el espacio de nombres de métrica oci_digitalassistant.

A continuación se muestran las métricas disponibles para las instancias de Oracle Digital Assistant.

Puede ver métricas por instancia de servicio individual o en formulario agregado para todas las instancias.

Para ver las métricas de una instancia de servicio individual:

1. En la consola de Infrastructure, haga clic en en la esquina superior izquierda para abrir el menú de navegación, seleccione Análisis y AI y, a continuación, haga clic en Digital Assistant.
2. Seleccione el compartimento de la instancia.
3. Seleccione la instancia.
4. Desplácese hacia abajo hasta la sección Métricas de la página para ver las métricas.

Para ver métricas agregadas para todas las instancias de servicio:

1. En la consola de Infrastructure, haga clic en en la esquina superior izquierda para abrir el menú de navegación, seleccione Observación y gestión y, a continuación, haga clic en Métricas de servicio.
2. En el elemento desplegable Compartimentos, seleccione el compartimento cuyas métricas desea ver.
3. En Espacio de nombre de métrica, seleccione oci_digitalassistant.

La consola de Infrastructure proporciona varias herramientas de facturación y pago que facilitan la supervisión de los costos del servicio, facturación y uso de Oracle Digital Assistant.

Para ver la facturación y el uso, realice los siguientes pasos:

1. Conéctese a Oracle Cloud. Puede encontrar el nombre de su cuenta y la información de conexión en el correo electrónico de bienvenida.
2. En la consola de Infrastructure, haga clic en la esquina superior izquierda para abrir el menú de navegación, seleccione Gobernanza y administración y, a continuación, seleccione una de las siguientes opciones:

   • Análisis de costos: proporciona herramientas de visualización fáciles de usar para facilitar el seguimiento y optimización de sus gastos.

   • Informes de uso y costos: permite ver los archivos de valores separados por comas (CSV) que se pueden usar para obtener desgloses detallados de recursos para la conciliación de auditorías o facturas.

     Nota
     
     

     La primera vez que acceda a los informes de uso, debe crear una política en su compartimento raíz. Siga las instrucciones de la página Informe de uso para crear la política, mediante la copia de las sentencias indicadas.

   • Presupuestos: permite definir los umbrales del gasto. Puede definir alertas en el presupuesto para saber cuándo excedería el presupuesto, así como ver todos los presupuestos y gastos en un solo lugar.

   • Facturas: permite ver y descargar las facturas del uso.

Para obtener más información sobre las herramientas de facturación y pago, consulte Visión general de las herramientas de facturación y pago.

Si envía una solicitud de servicio (SS) y los Servicios de Soporte Oracle determinan que necesitan acceso a algunos de sus datos para la depuración, puede aceptar otorgarles acceso temporal a los datos de su instancia de servicio. Este es el flujo general del proceso:

1. Envía una solicitud de servicio.
2. Si los Servicios de Soporte Oracle determinan que necesitan acceso a cualquiera de sus datos con fines de depuración, se pondrán en contacto con el administrador por correo electrónico para que dé su aprobación a la realización de una sesión de Break Glass. (El correo electrónico tiene un enlace a la página Aprobación de acceso temporal de su instancia de Digital Assistant, donde el administrador puede hacer clic en Aprobar o Rechazar).
3. Si el administrador aprueba la solicitud, se genera una contraseña temporal que permite a los Servicios de Soporte Oracle iniciar una sesión de Break Glass con la que puedan acceder a los datos necesarios.
4. Una vez que los Servicios de Soporte Oracle completan su trabajo en la sesión de Break Glass, finalizan la sesión. Si no terminan de forma explícita la sesión, esta caduca automáticamente dentro del plazo que haya acordado.

Por defecto, Oracle proporciona y gestiona las claves de TDE para cifrar los datos en la instancia de Digital Assistant.

Si la instancia tiene la opción Break Glass activada, también puede sustituir la clave privada proporcionada por Oracle por la suya, lo que también le permite rotar las claves según sea necesario.

Oracle Digital Assistant está diseñado para ofrecer alta disponibilidad (HA). Sin embargo, si necesita asegurarse de que su instancia aún puede funcionar si un desastre afecta a la región de su instancia, puede solicitar que se configure el failover entre regiones.

Cuando se configura el failover entre regiones y la instancia principal se cae:

• Cualquier solicitud de tiempo de ejecución a la instancia principal se redirige a la instancia de copia de seguridad.
• Aparece un banner en la interfaz de usuario de Digital Assistant que indica que se está utilizando la instancia de copia de seguridad.
• No debe realizar ningún trabajo en aptitudes, asistentes digitales, canales, estadísticas u otros artefactos (ya sea a través de la interfaz de usuario o a través de las API de REST) en la instancia de copia de seguridad. Los cambios que realice en la instancia de copia de seguridad no se conservarán cuando se restaure la instancia principal.

Cuando finaliza la interrupción:

• Se restaura el servicio a la instancia principal.
• Los datos de estadísticas acumulados en la instancia de copia de seguridad se conservan y se combinan con los datos de estadísticas existentes asociados a la instancia principal.
• Los artefactos, como las aptitudes y los asistentes digitales, se restauran al estado en el que estaban cuando la instancia principal se cayó. (De forma práctica, esto simplemente significa que los cambios que se realicen en estos artefactos de la instancia de copia de seguridad no se conservarán).

Para configurar el failover entre regiones:

1. Archivar una solicitud de servicio (SR) para failover entre regiones y, en la solicitud, mencionar la URL de instancia de la instancia principal de Digital Assistant.
2. Una vez que el equipo de soporte le haya respondido con información sobre las regiones de copia de seguridad disponibles, suscríbase a una región de copia de seguridad en la consola de OCI.

   A continuación, el equipo de soporte creará la instancia de copia de seguridad.

Durante la configuración de failover, se configura una aptitud de nivel de sistema (denominada Echo) en la instancia que ha especificado y expuesto a través de un canal web (denominado heartbeat) en esa instancia. Desde la región de copia de seguridad, la instancia principal se sondea periódicamente para conocer su estado a través de esta aptitud.

Para configurar un punto final privado para Digital Assistant, siga estos pasos generales:

1. Asegúrese de que tiene los permisos necesarios para configurar puntos finales privados y asociarlos a instancias de Digital Assistant.
2. Si aún no las tiene, en la consola de OCI, cree una red virtual en la nube (VCN) y sus recursos asociados, incluidos:
   • Al menos una subred.
   • Tablas de rutas para enrutar el tráfico a través de la subred a sus destinos.
   • Listas de seguridad o grupos de seguridad de red para establecer un juego de reglas de seguridad de entrada y salida que utilizará para el punto final privado.
   • Opcionalmente, un gateway de internet para otorgar acceso a internet a la VCN.
   • Opcionalmente, un gateway de NAT (traducción de direcciones de red), que ofrece acceso a Internet a los recursos que no tienen direcciones IP públicas, sin exponerlos a las conexiones de Internet entrantes.

   Consulte la documentación de OCI para redes virtuales en la nube y subredes.

3. Cree el punto final privado y asócielo a la instancia de Digital Assistant.
4. En Digital Assistant, configure un servicio de datos o un servicio REST que apunte al punto final.

Para configurar puntos finales privados, debe tener los permisos adecuados en la consola de Infrastructure.

Hay dos tipos de recursos para puntos finales privados que incluyen estos permisos necesarios:

• oda-private-endpoints: permite configurar puntos finales privados y proxies de SCAN.
• oda-private-endpoint-attachments: permite asociar un punto final privado a una instancia de Digital Assistant.

Los permisos para esos tipos de recursos también forman parte del tipo de recurso oda-family. Por lo tanto, si está cubierto por una sentencia de política para gestionar tipos de recursos oda-family en el compartimento donde está el punto final privado, no tiene que crear políticas independientes para los puntos finales privados.

A continuación, se muestran ejemplos de políticas amplias que permiten la creación y configuración de puntos finales privados y su asociación a instancias de Digital Assistant.

allow group <group-name> to manage oda-private-endpoints in compartment <private-endpoint-compartment>
allow group <group-name> to manage oda-private-endpoint-attachments in compartment <private-endpoint-compartment>

Para obtener más información sobre cómo funcionan las políticas, consulte Políticas de Digital Assistant.

1. 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).
2. En la navegación izquierda de la página Servicios de AI que aparece, haga clic en Puntos finales privados.
3. Si aún no lo ha hecho, cree el compartimento en el que desea mantener el punto final privado y, opcionalmente, agregue la VCN y la subred que utilizará a ese compartimento.

   Consulte Understanding Compartments y Managing Compartments.

4. Haga clic en Crear punto final privado y rellene los campos necesarios, incluida la VCN y la subred privada.
5. Una vez creado el punto final, haga clic en Asociar instancia de ODA, seleccione el compartimento que contiene la instancia de Digital Assistant que desea que pueda utilizar el punto final privado y, a continuación, seleccione esa instancia.

Una vez creado un punto final privado, debe agregar un servicio para ese punto final privado para utilizarlo en Digital Assistant.

• Para agregar un servicio de datos para el punto final privado, consulte Conexión al servicio de datos.
• Para agregar un servicio REST para el punto final privado, consulte Adición de un servicio REST para un punto final.

Si utiliza el punto final privado para una base de datos con RAC activado, también debe configurar un proxy SCAN para el punto final privado.

Para configurar un proxy SCAN:

1. Obtenga el nombre y el número de puerto del DNS de SCAN para la base de datos.
   • Si la base de datos es una base de datos local, consíguela al administrador de la base de datos.
   • Si la base de datos está en OCI, realice lo siguiente en la consola de Infrastructure:
     1. Vaya a la página Detalles de sistema de base de datos de la base de datos y seleccione el separador Información de sistema de base de datos.
     2. En la sección Red de la página, copie el nombre de DNS de SCAN y péguelo en un lugar conveniente.
     3. Tenga en cuenta el número de puerto.
2. En la consola de Infrastructure, haga clic en en la parte superior izquierda para abrir el menú de navegación, seleccione Análisis e IA y seleccione Puntos finales privados (que aparece en la categoría Servicios de IA de la página).
3. Seleccione el punto final privado.
4. En la sección Recursos de la página, seleccione Proxies de SCAN.
5. Haga clic en Agregar proxy SCAN.
6. En el cuadro de diálogo Agregar proxy SCAN, seleccione el tipo (FQDN (para el nombre de dominio completo) o Dirección IP) y, a continuación, rellene el resto de los campos necesarios.
   • Si ha seleccionado FQDN como tipo de proxy, utilice el nombre de DNS de SCAN de la base de datos para el Nombre de host y el número de puerto de la base de datos como Puerto.
   • Si ha seleccionado Dirección IP como tipo de proxy, haga clic en Agregar listener de SCAN para agregar direcciones IP y números de puerto para uno o más listeners de SCAN en la base de datos.

En general, el proceso de importación de paquetes mediante la API (ya sea directamente o a través de la CLI o de uno de los SDK) es:

1. Si aún no existe, cree la instancia de Oracle Digital Assistant donde desea importar el paquete.
   1. Llame a CreateOdaInstance para crear la instancia.
   2. En la respuesta a la llamada CreateOdaInstance, tome el valor de cabecera de respuesta opc-work-request-id y utilícelo para llamar a GetWorkRequest para supervisar el progreso de la operación de creación de instancias.
   3. Una vez finalizada la creación de la instancia, utilice el valor del atributo odaInstanceId que se ha devuelto en el cuerpo de la respuesta para llamar a GetOdaInstance.
2. Llame a ListPackages para ver qué paquetes están disponibles para la instancia (o instancias) que especifique.
3. Para cualquier paquete disponible que desee importar, llame a GetPackage para obtener el contrato de importación del paquete.

   El contrato de importación especifica las condiciones que se deben cumplir para poder importar el paquete. Esto puede incluir aspectos como la especificación de un proveedor de autenticación y el relleno de valores para parámetros personalizados.

4. Cumpla el contrato de importación.

   Para ello, cree una carga útil que proporcione valores para todos los parámetros necesarios en el contrato de importación. La carga útil puede tener un aspecto similar al siguiente:

   {
       "packageId": "<packageId-OCID>",
       "parameterValues": {
           "authProvider.providerX.clientSecret": "some value",
           "authProvider.providerX.authorizationEndpointUrl": "http://host:80/file",
           "authProvider.providerX.revokeEndpointUrl": "http://host:80/file",
           "authProvider.providerX.allowedScopes": "some value",
           "authProvider.providerX.tokenEndpointUrl": "http://host:80/file",
           "authProvider.IDCS_OAuthForIDR.allowedScopes": "some value",
           "authProvider.providerX.clientId": "some value",
           "skillParameter.da.backendRestEndPoint": "http://host:80/file",
       }
   }

   Para simplificar esta tarea, la respuesta GetPackage contiene una sección denominada defaultParameterValues que puede utilizar para ensamblar la parte de valor de parámetro de la carga útil.

5. Importe el paquete a las instancias.
   1. Llame a CreateImportedPackage utilizando la carga útil que acaba de ensamblar.
   2. En la respuesta a la llamada CreateImportedPackage, tome el valor de cabecera de respuesta opc-work-request-id y utilícelo para llamar a GetWorkRequest para supervisar el progreso de la operación de importación de paquetes.
   3. Una vez finalizada la importación del paquete, utilice el valor del atributo odaInstanceId que se ha devuelto en el cuerpo de la respuesta para llamar a GetImportedPackage para ver los detalles del paquete.

Si hay disponible una actualización para un paquete, puede agregar ese paquete actualizado a la instancia mediante la operación UpdateImportedPackage.