次に、検索機能を使用してすべての削除操作を表示する方法の例を示します:

1. 「+基準」をクリックします。
2. 「フィルタ」フィールドで、「操作」を選択します。
3. 「演算子」フィールドで、「次で始まる」を選択します。
4. 「値」フィールドに、Deleteと入力します。
5. 「検索」をクリックします。

この検索の結果では、DeleteSkillやDeleteSkillIntentなど、Deleteで始まる名前を持つすべての操作のエントリが表示されます。

次に、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

これは、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"
}

Oracle Digital Assistantメトリックは、メトリック・ネームスペースoci_digitalassistantを使用して生成されます。

次に、Oracle Digital Assistantインスタンスに対して使用可能なメトリックを示します。

メトリックは、個々のサービス・インスタンス別に表示することも、すべてのインスタンスを集計した形式で表示することもできます。

個々のサービス・インスタンスのメトリックを表示するには:

1. インフラストラクチャ・コンソールで、左上のをクリックしてナビゲーション・メニューを開き、「分析およびAI」を選択し、「デジタル・アシスタント」をクリックします。
2. インスタンスのコンパートメントを選択します。
3. インスタンスを選択します。
4. ページの「メトリック」セクションまでスクロールして、メトリックを表示します。

すべてのサービス・インスタンスの集計メトリックを表示するには:

1. インフラストラクチャ・コンソールで、左上のをクリックしてナビゲーション・メニューを開き、「監視および管理」を選択し、「サービス・メトリック」をクリックします。
2. 「コンパートメント」ドロップダウンで、メトリックを表示するコンパートメントを選択します。
3. 「メトリック・ネームスペース」で、「oci_digitalassistant」を選択します。

インフラストラクチャ・コンソールには、Oracle Digital Assistantの請求、サービス・コストおよび使用状況のモニターを容易にする様々な請求および支払ツールがあります。

請求および使用状況を表示するには、次のステップを実行します:

1. クラウド・アカウント管理者としてOracle Cloudにサインインします。アカウント名とログイン情報は、ようこそ電子メールに記載されています。
2. インフラストラクチャ・コンソールで、左上のをクリックしてナビゲーション・メニューを開き、「ガバナンスと管理」を選択して、次のいずれかのオプションを選択します:

   • コスト分析: 支出の追跡と最適化に役立つ、使いやすいビジュアライゼーション・ツールを提供します。

   • コストおよび使用状況レポート: 監査または請求書照合用にリソースの詳細な内訳が得られる、カンマ区切り値(CSV)ファイルを表示します。

     ノート
     
     

     使用状況レポートに初めてアクセスする際、ルート・コンパートメントにポリシーを作成する必要があります。「使用状況レポート」ページの手順に従ってポリシーを作成し、指示どおり文をコピーします。

   • 予算: 支出のしきい値を設定します。予算にアラートを設定して、予算を超える可能性があるときに通知を受けることができます。また、予算と支出のすべてを1箇所から表示できます。

   • 請求書: 使用状況に対する請求書を表示およびダウンロードします。

請求および支払ツールの詳細は、請求および支払ツールの概要を参照してください。

ユーザーがサービス・リクエスト(SR)を送信し、Oracleサポートが、デバッグ目的で一部のデータにアクセスする必要があると判断した場合、ユーザーはサービス・インスタンス・データへの一時アクセス権を付与することに同意できます。このプロセスの一般的なフローは次のとおりです:

1. SRを送信します。
2. デバッグ目的でデータにアクセスする必要があるとOracleサポートが判断した場合は、緊急アクセス・セッションを実行する承認を得るために、管理者に電子メールで連絡します。(この電子メールには、デジタル・アシスタントの「一時アクセス承認」ページへのリンクが含まれています。このページで、管理者は、「承認」または「却下」をクリックできます。)
3. 管理者がリクエストを承認すると、一時パスワードが生成され、Oracleサポートが緊急アクセスセッションを開始でき、必要なデータにアクセスできるようになります。
4. Oracleサポートは、緊急アクセス・セッションの作業を完了すると、セッションを終了します。セッションを明示的に終了しなくても、同意した時間内に自動的に期限切れになります。

デフォルトでは、デジタル・アシスタント・インスタンスのデータを暗号化するTDEキーはOracleによって提供および管理されます。

インスタンスで緊急アクセスが有効になっている場合、Oracle提供の秘密キーを独自の秘密キーに置き換えることもできます。この方法で、必要に応じてキーをローテーションすることもできます。

Oracle Digital Assistantは、高可用性(HA)対応として設計されています。ただし、インスタンスのリージョンで障害が発生してもインスタンスが機能できるようにする必要がある場合、クロス・リージョン・フェイルオーバーの設定を依頼できます。

クロス・リージョン・フェイルオーバーが設定されており、プライマリ・インスタンスが停止したとき:

• プライマリ・インスタンスへのすべてのランタイム・リクエストは、バックアップ・インスタンスにリダイレクトされます。
• バックアップ・インスタンスが使用されていることを示すバナーがデジタル・アシスタントのUIに表示されます。
• バックアップ・インスタンスでは、スキル、デジタル・アシスタント、チャネル、インサイトまたはその他のアーティファクトに対する作業は、(UIを使用するかREST APIを使用するかに関係なく)行わないでください。バックアップ・インスタンスで行った変更は、プライマリ・インスタンスのリストア時に保持されません。

停止が終了したとき:

• プライマリ・インスタンスへのサービスがリストアされます。
• バックアップ・インスタンスに蓄積されたインサイト・データは保持され、プライマリ・インスタンスに関連付けられた既存のインサイト・データと結合されます。
• スキルやデジタル・アシスタントなどのアーティファクトは、プライマリ・インスタンスが停止したときの状態にリストアされます。(つまり、バックアップ・インスタンスでこれらのアーティファクトに加えた変更は保持されません。)

クロス・リージョン・フェイルオーバーを設定するには:

1. クロスリージョン・フェイルオーバーのサービス・リクエスト(SR)を申請し、リクエストでプライマリDigital AssistantインスタンスのインスタンスURLを指定します。
2. サポート・チームが、使用可能なバックアップ・リージョンに関する情報で応答したら、OCIコンソールでバックアップ・リージョンにサブスクライブします。

   その後、サポート・チームがバックアップ・インスタンスを作成します。

フェイルオーバーの設定中に、指定したインスタンスにシステム・レベルのスキル(Echo)が設定され、そのインスタンスのWebチャネル(heartbeat)を介して公開されます。バックアップ・リージョンから、プライマリ・インスタンスは、このスキルを介して定期的にヘルス・ステータスについてポーリングされます。

デジタル・アシスタントのプライベート・エンドポイントを設定するには、次の一般的なステップに従います:

1. プライベート・エンドポイントを構成し、デジタル・アシスタント・インスタンスにアタッチするために必要な権限があることを確認します。
2. まだ配置されていない場合は、OCIコンソールで、次のような仮想クラウド・ネットワーク(VCN)とその関連リソースを作成します:
   • 少なくとも1つのサブネット。
   • ルート表: サブネットを介してトラフィックを宛先にルーティングします。
   • セキュリティ・リストまたはネットワーク・セキュリティ・グループ: プライベート・エンドポイントに使用するイングレスおよびエグレス・セキュリティ・ルールのセットを確立します。
   • オプションで、VCNへのインターネット・アクセスを提供するインターネット・ゲートウェイ。
   • オプションで、NAT (ネットワーク・アドレス変換)ゲートウェイ。これにより、受信インターネット接続に公開されることなく、パブリックIPアドレスを持たないリソースがインターネットにアクセスできます。

   VCNおよびサブネットのOCIドキュメントを参照してください。

3. プライベート・エンドポイントを作成し、それをデジタル・アシスタント・インスタンスに関連付けます。
4. デジタル・アシスタントで、エンドポイントを指すデータ・サービスまたはRESTサービスを構成します。

プライベート・エンドポイントを設定するには、インフラストラクチャ・コンソールで適切な権限を持っている必要があります。

プライベート・エンドポイントには、次の必要な権限を含む2つのリソース・タイプがあります:

• oda-private-endpoints - プライベート・エンドポイントおよびSCANプロキシを構成できます。
• oda-private-endpoint-attachments - デジタル・アシスタント・インスタンスのプライベート・エンドポイントをアタッチできます。

これらのリソース・タイプの権限も、oda-familyリソース・タイプの一部です。そのため、プライベート・エンドポイントがあるコンパートメント内のoda-familyリソース・タイプを管理するポリシー・ステートメントでカバーされている場合は、プライベート・エンドポイント用に個別のポリシーを作成する必要はありません。

プライベート・エンドポイントの作成と構成を有効にし、それらをデジタル・アシスタント・インスタンスにアタッチする広範なポリシーの例を次に示します。

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>

ポリシーの動作の詳細は、デジタル・アシスタントのポリシーを参照してください。

1. インフラストラクチャ・コンソールで、左上のをクリックしてナビゲーション・メニューを開き、「分析およびAI」を選択して、「デジタル・アシスタント」(ページの「AIサービス」カテゴリ内に表示される)を選択します。
2. 表示される「AIサービス」ページの左側のナビゲーションで、「プライベート・エンドポイント」をクリックします。
3. まだ作成していない場合は、プライベート・エンドポイントを保持するコンパートメントを作成し、オプションで、使用するVCNおよびサブネットをそのコンパートメントに追加します。

   コンパートメントの理解およびコンパートメントの管理を参照してください。

4. 「プライベート・エンドポイントの作成」をクリックし、VCNおよびプライベート・サブネットを含む必須フィールドに入力します。
5. エンドポイントが作成されたら、「ODAインスタンスの関連付け」をクリックし、プライベート・エンドポイントを使用できるようにするデジタル・アシスタント・インスタンスを含むコンパートメントを選択してから、そのインスタンスを選択します。

プライベート・エンドポイントを作成したら、そのプライベート・エンドポイントのサービスを追加してデジタル・アシスタントで使用する必要があります。

• プライベート・エンドポイントのデータ・サービスを追加するには、データ・サービスへの接続を参照してください。
• プライベート・エンドポイントのRESTサービスを追加するには、エンドポイントのRESTサービスの追加を参照してください。

RAC対応データベースのプライベート・エンドポイントを使用している場合は、プライベート・エンドポイントのSCANプロキシも構成する必要があります。

SCANプロキシを設定するには:

1. データベースのSCAN DNS名およびポート番号を取得します。
   • データベースがオンプレミス・データベースである場合は、データベース管理者から取得します。
   • データベースがOCI上にある場合は、インフラストラクチャ・コンソールで次を実行します:
     1. データベースのDB Systemの詳細ページにナビゲートし、「DBシステム情報」タブを選択します。
     2. このページの「ネットワーク」セクションで、SCAN DNS名をコピーして、便利な場所に貼り付けます。
     3. 「ポート番号」に注意してください。
2. インフラストラクチャ・コンソールで、左上のをクリックしてナビゲーション・メニューを開き、「分析およびAI」を選択して、「プライベート・エンドポイント」(ページの「AIサービス」カテゴリ内に表示される)を選択します。
3. プライベート・エンドポイントを選択します。
4. ページの「リソース」セクションで、「SCANプロキシ」を選択します。
5. 「SCANプロキシの追加」をクリックします。
6. 「SCANプロキシの追加」ダイアログで、タイプ(「FQDN」(完全修飾ドメイン名の場合)または「IPアドレス」)を選択し、残りの必須フィールドに入力します。
   • プロキシ・タイプとしてFQDNを選択した場合は、データベースのSCAN DNS名をホスト名に、データベースのポート番号をポートとして使用します。
   • プロキシ・タイプとして「IPアドレス」を選択した場合は、「SCANリスナーの追加」をクリックして、データベース内の1つ以上のSCANリスナーのIPアドレスおよびポート番号を追加します。

一般に、APIを使用してパッケージをインポートするプロセス(直接またはCLIまたはSDKのいずれかを介して)は次のとおりです。

1. まだ存在しない場合は、パッケージをインポートするOracle Digital Assistantインスタンスを作成します。
   1. CreateOdaInstanceをコールしてインスタンスを作成します。
   2. CreateOdaInstanceコールに対するレスポンスから、opc-work-request-idレスポンス・ヘッダー値を取得し、それを使用してGetWorkRequestをコールし、インスタンス作成操作の進行状況をモニターします。
   3. インスタンスの作成が完了したら、レスポンス本文で戻されたodaInstanceId属性の値を使用してGetOdaInstance.をコールします。
2. ListPackagesをコールして、指定したインスタンス(またはインスタンス)で使用可能なパッケージを確認します。
3. インポートする使用可能なパッケージについては、GetPackageをコールしてパッケージのインポート契約を取得します。

   インポート契約では、パッケージをインポートする前に満たす必要がある条件を指定します。これには、認証プロバイダの指定やカスタム・パラメータの値の入力などが含まれます。

4. 輸入契約を締結。

   これを行うには、インポート契約のすべての必須パラメータの値を提供するペイロードを作成します。ペイロードは次のようになります。

   {
       "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",
       }
   }

   このタスクを簡略化するために、GetPackageレスポンスには、ペイロードのパラメータ値部分をアセンブルするために使用できるdefaultParameterValuesというセクションが含まれています。

5. パッケージをインスタンスにインポートします。
   1. アセンブルしたペイロードを使用してCreateImportedPackageをコールします。
   2. CreateImportedPackageコールに対するレスポンスから、opc-work-request-idレスポンス・ヘッダー値を取得し、それを使用してGetWorkRequestをコールし、パッケージ・インポート操作の進行状況をモニターします。
   3. パッケージのインポートが完了したら、レスポンス本文で返されたodaInstanceId属性の値を使用してGetImportedPackageをコールし、パッケージの詳細を表示します。

パッケージの更新が使用可能な場合は、UpdateImportedPackage操作を使用して、その更新済パッケージをインスタンスに追加できます。