Canvas を構成する

このページでは、管理者が Gemini Enterprise でユーザー向けに Canvas を設定して構成する方法について説明します。

Canvas は、グローバル、米国、EU のリージョンで一般提供されています。Gemini Enterprise Business エディション、Standard エディション、Plus エディションのユーザーが利用できます。

始める前に

Canvas はデフォルトで無効になっています。ユーザーに対して有効にする前に、Canvas を確認してテストできます。

ユーザー向けに Canvas を有効にするには、次の設定を完了します。

Gemini Enterprise アプリで Canvas をオンにする

ユーザーが Canvas 機能にアクセスするには、Gemini Enterprise 管理者がウェブアプリの機能管理設定で [キャンバスを有効にする] 切り替えをオンにする必要があります。詳細については、ウェブアプリの機能を管理するをご覧ください。

カスタム IAM ロールに Canvas 権限を追加する

ユーザーに Canvas の必要な権限があることを確認します。

  • 事前定義ロール: roles/discoveryengine.user などの標準ロールで Gemini Enterprise にアクセスするユーザーは、必要な権限が事前定義ロールに含まれているため、変更を行う必要はありません。

  • カスタムロール: カスタム IAM ロールを使用して Gemini Enterprise にアクセスするユーザーの場合は、カスタムロールに immersiveArtifacts 権限を追加する必要があります。これらの権限がないと、ユーザーは Canvas を使用できません。Canvas には次の権限が必要です。

    • discoveryengine.immersiveArtifacts.create
    • discoveryengine.immersiveArtifacts.delete
    • discoveryengine.immersiveArtifacts.export
    • discoveryengine.immersiveArtifacts.get
    • discoveryengine.immersiveArtifacts.list
    • discoveryengine.immersiveArtifacts.navigate
    • discoveryengine.immersiveArtifacts.update

    Canvas に必要な権限はプレビュー版であるため、 Google Cloud コンソールを使用して追加することはできません。代わりに gcloud CLI を使用してください。たとえば、これらの権限を既存のプロジェクト レベルのカスタムロールに追加するには、次のコマンドを実行します。

    gcloud iam roles update ROLE_ID \
  --project=PROJECT_ID \
  --add-permissions=discoveryengine.immersiveArtifacts.create,discoveryengine.immersiveArtifacts.delete,discoveryengine.immersiveArtifacts.export,discoveryengine.immersiveArtifacts.get,discoveryengine.immersiveArtifacts.list,discoveryengine.immersiveArtifacts.navigate,discoveryengine.immersiveArtifacts.update

    Gemini Enterprise IAM ロールの管理の詳細については、IAM によるアクセス制御をご覧ください。

制限事項

キャンバスはモバイルアプリではサポートされていません。ウェブアプリでのみ利用できます。

割り当ての使用量

Canvas クエリと通常の Gemini Enterprise app のチャット クエリは同じようにカウントされ、同じ割り当てを共有します。

次のいずれかのシナリオでアシスタントとチャットしたり、Gemini Enterprise の機能を使用したりすると、Gemini Enterprise アプリに「使用量上限に達しました」というエラー メッセージが表示されます。

  • プロジェクトの月額費用の上限に達しました。
  • プロジェクトが特定の機能のプール割り当て上限を超えており、Gemini Enterprise 管理者が超過を有効にしていない。

このエラーは、上限に達した機能にのみ影響します。割り当てが残っている他の機能は引き続き使用できます。