プロジェクトとエージェントの設定

プロジェクトのロケーション、エージェント アプリケーション、エージェントの各レベルでさまざまな設定を制御できます。

プロジェクトの位置情報の設定

プロジェクトのロケーションの設定は、特定のプロジェクトとロケーション内のすべてのエージェント アプリケーションとエージェントに適用されます。 プロジェクトのロケーションの設定を編集するには、エージェント リストに移動して プロジェクトとロケーションを選択し、 設定 ボタンをクリックします。

次のプロジェクトと位置情報の設定を使用できます。

  • VPC Service Controls: VPC Service Controls をご覧ください。

  • 許可されたオリジン: VPC Service Controls を使用している場合は、エージェント アプリケーションの外部に呼び出しを行うときに許可される HTTP(S) エンドポイントを定義できます。 これにより、エージェントはプロキシ経由でトラフィックをルーティングすることなく、外部サービスと安全にやり取りできます。 これは、外部リクエストを行うことができるすべての種類のツールとコールバックに適用されます。 VPC Service Controls が有効になっていない場合（デフォルト）、すべてのエンドポイントが許可されます。 VPC Service Controls が有効になっている場合、許可されたオリジン リストに追加されていない限り、エンドポイントは許可されません。

    エンドポイントは、スキーマとオプションのポートを含む完全一致 URL（ワイルドカードなし）として提供されます。 例:

    • https://example.com:8443
    • https://api.example.com

    許可されたオリジンを管理するには、次の Identity and Access Management 権限が必要です。

    • ces.googleapis.com/securitysettings.get
    • ces.googleapis.com/securitysettings.update

    これらの権限は、エージェント データを編集するユーザーとは別に、セキュリティ管理者またはプロジェクト管理者に付与されるように設計されています。 これらの権限は、CES Admin 事前定義ロールに含まれています。

    この設定はプロジェクトとロケーションのレベルで適用され、組織はすべてのエージェント アプリケーションで許可されるオリジンを制御できます。 この設定は、エージェント アプリケーションごとまたはエージェントごとに適用することはできません。 API を使用して SecuritySettings EndpointControlPolicyを更新することもできます。

エージェント アプリケーションの設定

エージェント アプリケーションのグローバル設定を編集するには:

  1. ビルダーの右側にある設定アイコンをクリックします。

次のエージェント アプリケーションの設定を使用できます。

  • 基本:
    • インタラクション:
      • グローバル モデル: 個々のエージェントによってオーバーライドされない限り、 デフォルト で使用されるモデル。 一部のモデルは、テキストまたは音声用に最適化されている場合があります。
      • 言語設定:
        • デフォルトの言語: この言語で会話を開始します。
        • 追加の言語: エージェント アプリケーションが多言語対応の場合は、 追加の言語を指定します。 エージェント アプリケーションは、ユーザー入力に合わせて言語を自動的に切り替えます。
        • サポートされていない言語の処理: サポートされていない言語でユーザー入力が提供された場合、 エージェント アプリケーションはユーザーに一度入力を繰り返すよう求めます。 新しい入力でもサポートされていない言語が使用されている場合は、実行するアクションを選択します。
    • 動作:
      • 音声: 音声合成に使用される音声。
      • 周囲の音: エージェントが再生するバックグラウンド サウンド。
      • レスポンスの長さ: エージェントの冗長性を調整します。
      • ユーザーによる中断を許可: エンドユーザーがエージェントを中断できるようにします。
      • 中断時に適応: 有効にすると、 エージェントはユーザーが すべてを聞いていない可能性があることを考慮して、レスポンスを適応させようとします。
      • フォールバックの動作:
        • 再試行: AI がレスポンスを生成できない場合は、 エージェントが再試行する回数を選択します。
        • エージェントのレスポンス: エージェントは、再試行するたびにエンドユーザーに権限を求めます。 デフォルトのレスポンスをここで指定できます。 指定しない場合は、デフォルトのレスポンスが使用されます。
        • フォールバック: 最後の再試行後にエージェントが続行できない場合の処理を決定します。
    • エージェントの詳細:
      • 表示名: エージェント アプリケーションの表示名。
      • エージェントをロック: 変更が適用されないようにします。
      • メモ: 人が読める形式のエージェント アプリケーションの説明。 これはモデルに送信されません。
  • 高精度:
    • 音声:
      • 無音タイムアウト: ユーザー入力を待ってから、再開を促します。
      • 周囲の音の音量ゲイン: 周囲の音の音量を調整します。
      • キーパッド入力: 電話通話用にデュアルトーン マルチ周波数（DTMF）を設定します。デフォルトで有効になっています。
    • ロギング:
      • ログとデータ共有: ログと エージェント開発 のエージェント全体の設定を管理します。
        • インタラクション データ: 詳細な分析 と参照のためにインタラクション データを保存します。これには、シミュレートされたインタラクションとライブ インタラクション、トレースデータなどが含まれます。無効にすると、エージェントとの過去の会話を表示できなくなります。
      • 秘匿化を有効にする: センシティブ データを自動的に検出して削除します。
      • Cloud Logging を有効にする: ログを Cloud Loggingに自動的にストリーミングします。
      • ログを BigQuery にエクスポート: カスタム分析のためにログを BigQuery にエクスポートします。
      • 音声録音: 音声ファイルの Cloud Storage バケットのロケーションを出力します。
    • ツール:
      • 実行モード: ツール呼び出しを並列または順次実行します。
    • グローバルな指示: エージェント アプリケーション内のすべてのエージェントに対する指示。 これらの指示を使用して、エージェント間で安定した ID またはパーソナリティを設定できます。

エージェントの設定

ルートエージェントまたはサブエージェント固有の設定を編集するには:

  1. エージェント タイトル ボックスのコンテキスト メニューをクリックします。
  2. [構成を編集] を選択します。

次のルートエージェントとサブエージェントの設定を使用できます。

  • エージェント名: エージェントの表示名。スネークケースを使用します。
  • モデル: エージェントに使用される モデル 。
  • 説明: エージェントの説明。 この説明は、エージェント アプリケーション内の他のエージェントに提供されます。
  • カスタムコード: コールバックのコードを指定します。