すべてのプロダクト
Search

このプロダクト

    Quick BI:スマート Q 埋め込み

    ドキュメントセンター

    Quick BI:スマート Q 埋め込み

    最終更新日:Nov 10, 2025

    この Topic では、AI との Q&A チケット埋め込みソリューションを使用して、ログイン不要で Quick BI をサードパーティシステムに埋め込む方法について説明します。また、チケット管理を使用して、悪意を持って共有されたリンクからのデータ漏洩を防ぐ方法についても説明します。この機能は Professional 版でのみ利用可能です。

    背景情報

    Quick BI は、AI との Q&A チケット埋め込みソリューションと呼ばれる、セキュリティが強化された埋め込み分析ソリューションを提供します。Quick BI Professional 版を使用すると、リンク、アクセス、データクエリなど、さまざまなシナリオに対して包括的なセキュリティコントロールを実装できます。これにより、Quick BI を低コストで業務システムに統合し、独自のブランドアイデンティティを持つデータプロダクトを効率的に構築できます。

    重要

    現在、この機能は中国 (香港) およびマレーシアリージョンでのみ利用可能です。他のリージョンでのサポートも間もなく開始される予定です。

    制限事項

    Professional 版のみが AI との Q&A 埋め込みをサポートしています。

    注意事項

    AI との Q&A およびチケット埋め込みモジュールを購入する必要があります。

    データ Q&A API

    AI との Q&A の API 操作の詳細については、「AI との Q&A 埋め込み」をご参照ください。

    例

    • [データリソース別] オプションを使用してデータセットを埋め込む場合、または [分析サブジェクト別] オプションを使用して単一の分析サブジェクトを埋め込む場合、埋め込みインターフェイスには、承認されたすべてのデータセットがタイルレイアウトで表示されます。

      image

    • [分析サブジェクト別] オプションを使用して複数の分析サブジェクトを埋め込む場合、埋め込みインターフェイスには [すべて] の下と各分析サブジェクトの下にデータセットが表示されます。

      image

    ステップ 1: AI との Q&A 埋め込みを追加する

    AI との Q&A 埋め込みを追加するには、次のステップを実行します。

    1. Quick BI のホームページで、[組織管理] > [AI との Q&A] > [埋め込み管理] ページに移動します。

      image

    2. [埋め込みモジュールを追加] をクリックし、パラメーターを設定します。

      image

      説明

      現在、埋め込みモジュールは 1 つだけサポートされています。

      カテゴリ

      構成項目

      説明

      基本構成

      埋め込みモジュール名

      この名前はモジュールの識別子であり、作成後に変更することはできません。

      埋め込みモジュールタイプ

      デフォルト値は AI との Q&A です。このパラメーターは変更できません。

      タイムスタンプ範囲

      対象範囲として [データリソース別] または [分析サブジェクト別] を選択します。

      • [データリソース別]image

      • 分析サブジェクト別

        image

      カスタム構成

      モジュール名

      モジュール名をカスタマイズします。名前は最大 20 文字です。

      ロボットニックネーム

      ロボットのニックネームをカスタマイズします。ニックネームは最大 10 文字です。

      ロボットロゴ

      [素材を使用] するか、[カスタムイメージ] をアップロードします。

      説明

      ロボットのロゴは AI との Q&A エリアに表示されます。カスタムイメージは 48 × 48 ピクセル以下、PNG または JPG 形式で、サイズは 200 KB 以下である必要があります。

      image

      ナビゲーションバーの設定

      [会話履歴を表示] するかどうかを指定します。

      このオプションを選択すると、次の図に示すように、ナビゲーションバーに会話履歴が表示されます。image

    3. [OK して埋め込みコードをデバッグ] をクリックします。[埋め込みコードのデバッグ] ダイアログボックスで、パラメーターを設定します。

      image

      構成項目

      説明

      Ticket リンク

      チケットリンクを手動で入力するか、[クイック生成] をクリックしてチケットを生成します。

      image

      チケット生成ページで、[バインドされたユーザー]、[有効期間]、[アクセス回数] を設定できます。

      • [バインドされたユーザー]: 埋め込みレポートの権限を特定のユーザーにバインドできます。

      • [有効期間]: デフォルトの有効期間は 240 分です。有効期間はカスタマイズできます。最大有効期間は 240 分です。

      • [アクセス回数]: 1 を入力すると、生成されたリンクは 1 回しかアクセスできません。デフォルト値は 1 です。最大値は 9999 です。

      埋め込みコードを取得

      [URL] と [iframe コード] を生成できます。

    4. コピー をクリックします。

    ステップ 2: API 操作を呼び出して AccessTicket を生成する

    1. create4Copilot API 操作を呼び出して、埋め込みに必要なチケットを生成します。

      次の表に、AccessTicket を生成するためのパラメーターを示します。

      パラメーター

      タイプ

      説明

      CopilotId

      String

      埋め込みが有効になっている AI との Q&A モジュールの ID。

      TicketNum

      Integer

      チケットを使用できる回数。

      • デフォルト値：1

      • 推奨値：1

      • 最大値：99999

      チケットがアクセスに使用されるたびに、残りの使用回数が 1 ずつ減少します。

      UserId

      String

      Quick BI ユーザーの ID。Alibaba Cloud アカウント ID ではありません。

      QueryUserInfoByAccount API 操作を呼び出して UserId を取得できます。例: fe67f61a35a94b7da1a34ba174a7****。

      説明

      UserId または AccountName のいずれかを指定するだけで済みます。両方のパラメーターを空のままにすると、デフォルトで AI との Q&A 埋め込みを有効にしたオーナーが使用されます。

      AccountName

      String

      ユーザーアカウントの名前。

      • ユーザーが wangwu という名前の Alibaba Cloud アカウントの場合、フォーマットは [Alibaba Cloud アカウント] です。例: wangwu。

      • ユーザーが zhangsan**@aliyun.cn という名前の RAM ユーザーの場合、フォーマットは [Alibaba Cloud アカウント:RAM ユーザー] です。例: wangwu:zhangsan**。

      説明

      UserId または AccountName のいずれかを指定するだけで済みます。両方のパラメーターを空のままにすると、デフォルトで AI との Q&A 埋め込みを有効にしたオーナーが使用されます。

      AccountType

      Integer

      ユーザーアカウントのタイプ。

      • 1：Alibaba Cloud アカウント

      • 3: Quick BI アカウント

      • 4：DingTalk

      • 5：RAM ユーザー

      • 9：WeCom

      • 10：Lark

      説明

      AccountName を指定する場合は、AccountType も指定する必要があります。

      ExpireTime

      Integer

      チケットの有効期間。

      • 単位：分

      • デフォルト値：240

      説明

      リンクの共有を防ぐために、TicketNum パラメーターを 1 に設定することをお勧めします。これにより、生成されたサードパーティの埋め込みリンクに 1 回しかアクセスできなくなります。

    2. AccessTicket を生成します。

      サンプルコードについては、「CreateTicket4Copilot」をご参照ください。

      次のコードは、応答のサンプルを示しています。

      { 
  "requestId" : "7D784AB0-5B77-****-B628-E782B58D3898", 
  "result" : "fd138bcb-****-4fde-b413-81bcee59bdb6",
  "success" : true
}
      説明

      result パラメーターの値は、この API 呼び出しによって生成された AccessTicket です。この例では、AccessTicket は fd138bcb-****-4fde-b413-81bcee59bdb6 です。

    ステップ 3: ログイン不要の URL を構築する

    • 次の表に、構築プロセスと例を示します。

      プロセス

      AI との Q&A モジュールの例

      1. Quick BI ドメイン名を取得する

      bi.aliyun.com

      2. AI との Q&A 埋め込み URL を取得する

      token3rd/copilot

      3. AI との Q&A モジュール ID を取得する

      dd0****83f

      4. AccessTicket を取得する

      fd138bcb-****-4fde-b413-81bcee59bdb6

    • AI との Q&A URL のフォーマットは次のとおりです。

      https://<Quick BI ドメイン名>/<AI との Q&A 埋め込み URL>?copilotId=<AI との Q&A モジュール ID>&accessTicket=<AccessTicket>

      例: https://bi.aliyun.com/token3rd/copilot?copilotId=dd0****83f&accessTicket=fd138bcb-****-4fde-b413-81bcee59bdb6

    • 埋め込み表示の詳細については、「例」をご参照ください。

    埋め込みの管理

    [埋め込み管理] ページでは、既存の埋め込みモジュールを編集、デバッグ、およびシャットダウンできます。

    image

    • image アイコンをクリックして、埋め込みモジュールを編集します。

      説明

      埋め込みモジュール名は編集できません。

      image

      編集が完了したら、[OK] をクリックして [埋め込み管理] ページに戻るか、[OK して埋め込みコードをデバッグ] をクリックしてデバッグインターフェイスを開きます。

    • image アイコンをクリックして、埋め込みコードをデバッグします。

      image

    • image アイコンをクリックし、確認ダイアログボックスで [OK] をクリックして、埋め込みモジュールをシャットダウンします。

      image