アクションを管理する

アクションは、データストアの作成時または後で追加できます。このページでは、データストアの作成後に新しいアクションを追加し、アクションのリストを管理する手順について説明します。

アクションの追加

コンソール

データストアに新しいアクションを追加する手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. ナビゲーション メニューで [データストア] をクリックします。

  3. 任意のデータストアを選択します。

  4. ナビゲーション メニューから [操作] を選択します。

  5. [アクション] ページで、次の操作を行います。

    1. データストアの作成時にアクションが追加されなかった場合は、[アクションを有効にする] をクリックします。[アクションを有効にする] ページで、新しいアクションを追加するには、次の操作を行います。
      • 連携データストアの場合:
        1. リストからアクションを選択します。
        2. [アクションを有効にする] をクリックします。
      • 取り込みデータストアの場合:
        1. [認証設定] セクションを開き、認証の詳細を入力します。
          1. [ログイン] をクリックしてデータストアにログインし、アカウントを確認します。
          2. [続行] をクリックします。
        2. 省略可: [詳細設定] を開き、必要な詳細情報を入力します。
        3. 有効にするアクションを選択します。
        4. [アクションを有効にする] をクリックします。
    2. 既存のリストにアクションを追加する手順は次のとおりです。
      1. リストからアクションを選択します。
      2. [アクションを有効にする] をクリックします。

  6. データストアの作成に使用した認証情報とは異なる認証情報を使用して再認証する手順は次のとおりです。

    1. [操作] ページで [再認証] をクリックします。
    2. 認証の詳細を入力します。
    3. [ログイン] をクリックして、Gemini Enterprise がデータストアにアクセスできるように承認します。
    4. [更新] をクリックして、新しい認証情報を更新します。

  7. アクションのデータストア パラメータを表示または編集する手順は次のとおりです。

    1. [パラメータを表示/編集] をクリックして、コネクタ固有の詳細を編集します。たとえば、Microsoft Outlook、SharePoint、OneDrive の場合はテナント ID を指定します。
    2. [保存] をクリックして、パラメータの詳細を更新します。

アクションを表示

コンソール

データストアのアクション リストを表示する手順は次のとおりです。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. ナビゲーション メニューで [データストア] をクリックします。

  3. 任意のデータストアを選択します。

  4. ナビゲーション メニューから [操作] を選択します。データストアの作成時に有効にしたアクションが、[アクション] ページに表として表示されます。

アクションを無効にする

コンソール

アクションを無効にするには、次の操作を行います。

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. ナビゲーション メニューで [データストア] をクリックします。

  3. 任意のデータストアを選択します。

  4. ナビゲーション メニューから [操作] を選択します。

  5. 表から無効にするアクションを選択します。

  6. [アクションを無効にする] をクリックします。

カスタム アクションを管理する

Gemini Enterprise は、データストアでの高度な検索とアクションを可能にするカスタム フィールドとエンティティをサポートしています。データストアを作成したら、データソースから利用可能なオペレーションを取得し、アクションとして公開するオペレーションを選択できます。パフォーマンスを最適化するために、AI モデルの各アクションとそのフィールドの説明を調整することもできます。

これらのカスタム アクションは、Gemini Enterprise が提供するデフォルトのアクションに加えて使用できます。デフォルトで提供されるアクションについては、サポートされているアクションをご覧ください。

カスタム アクションとフィールドは、次の方法で構成できます。

  • カスタム エンティティ: データストアで定義されたカスタム エンティティからカスタム アクションを生成し、アクションとフィールドの説明を調整します。
  • カスタム フィールド: カスタム フィールドの入力方法を記述して、既存の標準アクションを変更します。

始める前に

Google Cloud コンソールでアクションを再読み込みする前に、カスタム エンティティとオペレーションがリモートのサードパーティ データソースによって構成され、公開されていることを確認してください。

カスタム エンティティに基づいてカスタム アクションを構成する

接続されたデータストアで定義されたカスタム エンティティに基づいて、新しいカスタム アクションのセットを自動的に生成できます。

カスタム アクションを生成して有効にするには:

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. ナビゲーション メニューで [データストア] をクリックします。

  3. データストアを選択します。

  4. ナビゲーション メニューで [アクション] をクリックします。

  5. [アクション] ページで、[カスタム アクションを再読み込み] をクリックしてアクション リストを生成します。

  6. アクション リストで、自動的に検出されたカスタム アクションを確認します。デフォルトでは、新しく生成されたアクションはすべて [無効] としてマークされます。

  7. 利用可能にするカスタム操作を選択します。

  8. [アクションを有効にする] をクリックします。選択したアクションのステータスが [有効] になっています。

  9. [保存] をクリックします。

  10. 省略可: ユーザー エクスペリエンスを向上させるため、仕様のアクションとフィールドの説明を充実させます。

    1. [アクション] ページで、仕様を変更するアクションを選択します。
    2. [仕様をダウンロード] をクリックして、仕様の JSON ファイルをダウンロードします。
    3. ダウンロードした JSON ファイルをテキスト エディタで開き、inputSchema の説明とデータ型を変更します。たとえば、パラメータの説明に「常にデフォルトを 10 にする」などの指示を追加できます。
    4. Google Cloud コンソールで、[仕様をアップロード] をクリックして、更新された JSON ファイルをアップロードします。仕様ファイルは、基本的な構文エラーについて検証されます。
    5. [保存] をクリックします。

標準アクションのカスタム フィールドを設定する

一部のデータストアでは、標準アクションが自動的に提供され、データストアの作成時にカスタム フィールドのサポートがデフォルトで有効になります。ただし、ツール仕様を変更することで、特定のカスタム フィールドをモデルでどのように処理するかを明示的に定義できます。

カスタム フィールド定義を使用して標準アクションを更新するには:

  1. Google Cloud コンソールで、[Gemini Enterprise] ページに移動します。

    Gemini Enterprise

  2. ナビゲーション メニューで [データストア] をクリックします。

  3. データストアを選択します。

  4. ナビゲーション メニューで [アクション] をクリックします。

  5. [仕様を管理] をクリックします。

  6. 更新する標準ツールまたはアクションを選択します。

  7. [仕様をダウンロード] をクリックして、仕様の JSON ファイルをダウンロードします。

  8. ダウンロードした JSON ファイルをテキスト エディタで開き、カスタム フィールドの定義、説明、データ型を inputSchema に追加します。

  9. Google Cloud コンソールで、[仕様をアップロード] をクリックして、更新された JSON ファイルをアップロードします。仕様ファイルは、基本的な構文エラーについて検証されます。

  10. [保存] をクリックします。

制限事項

更新トークンの有効期限が切れると、カスタム アクションの有効化がエラーで失敗したり、アクションが有効として表示されなかったりすることがあります。この問題を解決するには、[アクション] ページを再読み込みするか、接続されているアプリを再認証してトークンを更新します。