REST Resource: projects.locations.apps

リソース: アプリ

アプリは、ルート エージェントとそのサブエージェント、および関連する構成を含む、エージェントのグループの最上位コンテナとして機能します。これらのエージェントは、アプリのコンテキスト内で連携して特定の目標を達成します。

JSON 表現 
{
  "name": string,
  "displayName": string,
  "description": string,
  "pinned": boolean,
  "rootAgent": string,
  "languageSettings": {
    object (LanguageSettings)
  },
  "timeZoneSettings": {
    object (TimeZoneSettings)
  },
  "audioProcessingConfig": {
    object (AudioProcessingConfig)
  },
  "loggingSettings": {
    object (LoggingSettings)
  },
  "errorHandlingSettings": {
    object (ErrorHandlingSettings)
  },
  "modelSettings": {
    object (ModelSettings)
  },
  "toolExecutionMode": enum (App.ToolExecutionMode),
  "evaluationMetricsThresholds": {
    object (EvaluationMetricsThresholds)
  },
  "variableDeclarations": [
    {
      object (App.VariableDeclaration)
    }
  ],
  "predefinedVariableDeclarations": [
    {
      object (App.VariableDeclaration)
    }
  ],
  "globalInstruction": string,
  "guardrails": [
    string
  ],
  "dataStoreSettings": {
    object (DataStoreSettings)
  },
  "defaultChannelProfile": {
    object (ChannelProfile)
  },
  "metadata": {
    string: string,
    ...
  },
  "createTime": string,
  "updateTime": string,
  "etag": string,
  "deploymentCount": integer,
  "clientCertificateSettings": {
    object (ClientCertificateSettings)
  },
  "locked": boolean
}
フィールド
name

string

ID。アプリの固有識別子。形式: projects/{project}/locations/{location}/apps/{app}
displayName

string

必須。アプリの表示名。
description

string

省略可。アプリの説明（人が読める形式）。
pinned

boolean

省略可。アプリがアプリリストに固定されているかどうか。
rootAgent

string

省略可。ルート エージェントはアプリのエントリ ポイントです。形式: projects/{project}/locations/{location}/apps/{app}/agents/{agent}
languageSettings

object (LanguageSettings)

省略可。アプリの言語設定。
timeZoneSettings

object (TimeZoneSettings)

省略可。アプリのタイムゾーン設定。
audioProcessingConfig

object (AudioProcessingConfig)

省略可。アプリの音声処理構成。
loggingSettings

object (LoggingSettings)

省略可。アプリのロギング設定。
errorHandlingSettings

object (ErrorHandlingSettings)

省略可。アプリの設定のエラー処理。
modelSettings

object (ModelSettings)

省略可。アプリのデフォルトの LLM モデル設定。個々のリソース（エージェント、ガードレールなど）は、必要に応じてこれらの構成をオーバーライドできます。
toolExecutionMode

enum (App.ToolExecutionMode)

省略可。アプリのツール実行モード。指定しない場合、デフォルトは PARALLEL になります。
evaluationMetricsThresholds

object (EvaluationMetricsThresholds)

省略可。アプリの評価のしきい値。
variableDeclarations[]

object (App.VariableDeclaration)

省略可。変数の宣言。
predefinedVariableDeclarations[]

object (App.VariableDeclaration)

出力専用。アプリの事前定義変数の宣言。
globalInstruction

string

省略可。アプリ内のすべてのエージェントに対する指示。この指示を使用して、すべてのエージェントにわたって安定した ID または人格を設定できます。
guardrails[]

string

省略可。アプリのガードレールのリスト。形式: projects/{project}/locations/{location}/apps/{app}/guardrails/{guardrail}
dataStoreSettings

object (DataStoreSettings)

省略可。アプリのデータストア設定。
defaultChannelProfile

object (ChannelProfile)

省略可。アプリで使用されるデフォルトのチャンネル プロファイル。
metadata

map (key: string, value: string)

省略可。アプリに関するメタデータ。このフィールドは、アプリの詳細や想定される用途に関連する追加情報を保存するために使用できます。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
createTime

string (Timestamp format)

出力専用。アプリが作成されたときのタイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

出力専用。アプリが最後に更新されたときのタイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
etag

string

出力専用。読み取り、変更、書き込みオペレーション中にオブジェクトが変更されていないことを確認するために使用される ETag。etag が空の場合、更新によって同時変更が上書きされます。
deploymentCount

integer

出力専用。アプリのデプロイ数。
clientCertificateSettings

object (ClientCertificateSettings)

省略可。アプリのデフォルトのクライアント証明書設定。
locked

boolean

省略可。アプリが変更のためにロックされているかどうかを示します。アプリがロックされている場合、アプリリソースの変更は拒否されます。

LanguageSettings

アプリの言語設定。

JSON 表現 
{
  "defaultLanguageCode": string,
  "supportedLanguageCodes": [
    string
  ],
  "enableMultilingualSupport": boolean,
  "fallbackAction": string
}
フィールド
defaultLanguageCode

string

省略可。アプリのデフォルトの言語コード。
supportedLanguageCodes[]

string

省略可。defaultLanguageCode に加えてアプリでサポートされている言語コードのリスト。
enableMultilingualSupport

boolean

省略可。多言語サポートを有効にします。true の場合、アプリ内のエージェントは、多言語入力の処理を改善するために、事前構築済みの手順を使用します。
fallbackAction

string

省略可。エージェントがサポートされていない言語で入力を受け取ったときに行うアクション。

これは、事前定義されたアクションまたはカスタムのツール呼び出しにできます。有効な値は次のとおりです。- 特定のツールの実行をトリガーするツールの完全なリソース名。- 「エスカレーション」や「終了」などの事前定義されたシステム アクション。対応する metadata を含む EndSession シグナルをトリガーして、会話を終了します。

TimeZoneSettings

アプリのタイムゾーン設定。

JSON 表現 
{
  "timeZone": string
}
フィールド
timeZone

string

省略可。タイムゾーン データベースにあるアプリのタイムゾーン（例: America/Los_Angeles、Europe/Paris。

AudioProcessingConfig

入力音声と出力音声の処理と配信の方法に関する構成。

JSON 表現 
{
  "synthesizeSpeechConfigs": {
    string: {
      object (SynthesizeSpeechConfig)
    },
    ...
  },
  "bargeInConfig": {
    object (BargeInConfig)
  },
  "inactivityTimeout": string,
  "ambientSoundConfig": {
    object (AmbientSoundConfig)
  }
}
フィールド
synthesizeSpeechConfigs

map (key: string, value: object (SynthesizeSpeechConfig))

省略可。エージェントのレスポンスを合成する方法の構成。言語コードから SynthesizeSpeechConfig へのマッピング。

指定された言語コードの構成が見つからない場合は、ルート言語コードの構成が使用されます。たとえば、マップに「en-us」と「en」が含まれていて、指定された言語コードが「en-gb」の場合、「en」構成が使用されます。

注: 言語コードでは大文字と小文字が区別されません。

"key": value ペアのリストを含むオブジェクト。例: { "name": "wrench", "mass": "1.3kg", "count": "3" }
bargeInConfig

object (BargeInConfig)

省略可。ユーザーの割り込みアクティビティに対するエージェントの動作を構成します。
inactivityTimeout

string (Duration format)

省略可。エージェントがユーザーに再エンゲージメントを促すまでの、ユーザーの無操作（発話や操作がない）の継続時間。設定されていない場合、エージェントはユーザーに再エンゲージメントを促しません。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。
ambientSoundConfig

object (AmbientSoundConfig)

省略可。会話の自然さを高めるために、合成されたエージェントの回答とともに再生されるアンビエント サウンドの構成。

SynthesizeSpeechConfig

エージェントのレスポンスの合成方法の構成。

JSON 表現 
{
  "voice": string,
  "speakingRate": number
}
フィールド
voice

string

省略可。声の名前。設定しない場合、languageCode などの他のパラメータに基づいて音声が選択されます。

利用可能な音声の一覧については、Cloud Text-to-Speech のサポートされている音声と言語を参照してください。
speakingRate

number

省略可。発声速度。0.25 ～ 2.0 の範囲で指定します。1.0 は、特定の声でサポートされているネイティブの通常の発声速度を表します。2.0 はその 2 倍の速さで、0.5 は半分の速さです。範囲 [0.25, 2.0] 外の値を指定すると、エラーが返されます。

BargeInConfig

ユーザーの割り込みアクティビティの処理方法の構成。

JSON 表現 
{
  "disableBargeIn": boolean,
  "bargeInAwareness": boolean
}
フィールド
disableBargeIn
(deprecated)

boolean

省略可。エージェントが話している間、ユーザーの割り込みを無効にします。true の場合、エージェントの応答の再生中のユーザー入力は無視されます。

非推奨: ChannelProfile で disableBargeIn が非推奨となり、disableBargeInControl に置き換えられました。
bargeInAwareness

boolean

省略可。有効にすると、エージェントは、ユーザーが直前のエージェント メッセージをすべて聞いていないという前提に基づいて、次のレスポンスを調整します。エージェントの回答が視覚的に表示されるシナリオでは使用しないでください。

AmbientSoundConfig

会話の自然さを高めるために、合成されたエージェントの回答とともに再生されるアンビエント サウンドの構成。

JSON 表現 
{
  "volumeGainDb": number,

  // Union field source can be only one of the following:
  "prebuiltAmbientNoise": enum (AmbientSoundConfig.PrebuiltAmbientNoise),
  "gcsUri": string,
  "prebuiltAmbientSound": string
  // End of list of possible types for union field source.
}
フィールド
volumeGainDb

number

省略可。周囲のノイズによってサポートされるネイティブの通常の音量の音量ゲイン（dB 単位）。範囲は [-96.0, 16.0] です。未設定にするか、0.0（dB）に設定すると、ネイティブの通常の信号振幅で再生されます。-6.0（dB）に設定すると、ネイティブの通常の信号振幅の約半分の振幅で再生されます。+6.0（dB）に設定すると、ネイティブの通常の信号振幅の約 2 倍の振幅で再生されます。+10（dB）より大きい値を指定しないことを強くおすすめします。通常は、そのような大きい値を指定しても音量は効果的に増加しません。
共用体フィールド source。会話の自然さを高めるために、合成されたエージェントのレスポンスとともに再生される周囲のノイズ。source は次のいずれかになります。
prebuiltAmbientNoise
(deprecated)

enum (AmbientSoundConfig.PrebuiltAmbientNoise)

省略可。非推奨: prebuiltAmbientNoise は非推奨となり、prebuiltAmbientSound に置き換えられました。
gcsUri

string

省略可。Cloud Storage に保存されているモノラル チャンネルの 16 kHz WAV ファイルとしての周囲の雑音。

注: CES サービス エージェント service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com に Cloud Storage オブジェクトに対する storage.objects.get 権限があることを確認してください。
prebuiltAmbientSound

string

省略可。プリビルドのアンビエント サウンドの名前。有効な値は、- "coffee_shop" - "keyboard" - "keypad" - "hum" - "office_1" - "office_2" - "office_3" - "room_1" - "room_2" - "room_3" - "room_4" - "room_5" - "air_conditioner" です。

AmbientSoundConfig.PrebuiltAmbientNoise

プリビルドのアンビエント ノイズ。

列挙型
PREBUILT_AMBIENT_NOISE_UNSPECIFIED 指定されていません。
RETAIL_STORE 小売店の周囲のノイズ。
CONVENTION_HALL コンベンション ホールの周囲のノイズ。
OUTDOOR 街の周囲のノイズ。

LoggingSettings

アプリのロギング動作を記述する設定。

JSON 表現 
{
  "redactionConfig": {
    object (RedactionConfig)
  },
  "audioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "bigqueryExportSettings": {
    object (BigQueryExportSettings)
  },
  "cloudLoggingSettings": {
    object (CloudLoggingSettings)
  },
  "conversationLoggingSettings": {
    object (ConversationLoggingSettings)
  },
  "evaluationAudioRecordingConfig": {
    object (AudioRecordingConfig)
  },
  "metricAnalysisSettings": {
    object (MetricAnalysisSettings)
  }
}
フィールド
redactionConfig

object (RedactionConfig)

省略可。機密データを編集する方法の構成。
audioRecordingConfig

object (AudioRecordingConfig)

省略可。音声インタラクションの記録方法の構成。
bigqueryExportSettings

object (BigQueryExportSettings)

省略可。アプリの BigQuery エクスポートの動作を記述する設定。有効になっている場合、会話データは BigQuery テーブルにエクスポートされます。
cloudLoggingSettings

object (CloudLoggingSettings)

省略可。アプリの Cloud Logging の動作を記述する設定。
conversationLoggingSettings

object (ConversationLoggingSettings)

省略可。アプリの会話ログ記録の動作を記述する設定。
evaluationAudioRecordingConfig

object (AudioRecordingConfig)

省略可。評価のために音声インタラクションを記録する方法の構成。デフォルトでは、評価セッションで音声録音は有効になっていません。
metricAnalysisSettings

object (MetricAnalysisSettings)

省略可。アプリの LLM 分析パイプラインの会話データ収集の動作を記述する設定。

RedactionConfig

機密データの処理方法を指定する構成。

JSON 表現 
{
  "enableRedaction": boolean,
  "inspectTemplate": string,
  "deidentifyTemplate": string
}
フィールド
enableRedaction

boolean

省略可。true の場合、会話履歴、Cloud Logging、音声録音など、さまざまなロギング シナリオで秘匿化が適用されます。
inspectTemplate

string

省略可。機密データの種類の検出を構成する DLP 検査テンプレート名。

形式: projects/{project}/locations/{location}/inspectTemplates/{inspectTemplate}
deidentifyTemplate

string

省略可。コンテンツの匿名化方法を指定する DLP 匿名化テンプレート名。

形式: projects/{project}/locations/{location}/deidentifyTemplates/{deidentifyTemplate}

AudioRecordingConfig

音声操作の記録方法の構成。

JSON 表現 
{
  "gcsBucket": string,
  "gcsPathPrefix": string
}
フィールド
gcsBucket

string

省略可。セッションの音声録音を保存する Cloud Storage バケット。URI は「gs://」で始まる必要があります。

データ所在地に関する要件を満たすバケットのロケーションを選択してください。

注: Cloud Storage バケットがアプリとは異なるプロジェクトにある場合は、CES サービス エージェント service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com に storage.objects.create 権限を付与する必要があります。
gcsPathPrefix

string

省略可。音声録音の Cloud Storage パスの接頭辞。

この接頭辞には、次のプレースホルダを含めることができます。これらのプレースホルダは、配信時に動的に置き換えられます。- $project: プロジェクト ID - $location: アプリの場所 - $app: アプリ ID - $date: YYYY-MM-DD 形式のセッションの日付 - $session: セッション ID

パス接頭辞が指定されていない場合は、デフォルトの接頭辞 $project/$location/$app/$date/$session/ が使用されます。

BigQueryExportSettings

アプリの BigQuery エクスポートの動作を記述する設定。

JSON 表現 
{
  "enabled": boolean,
  "project": string,
  "dataset": string
}
フィールド
enabled

boolean

省略可。BigQuery エクスポートが有効かどうかを示します。
project

string

省略可。データのエクスポート先の BigQuery データセットのプロジェクト ID。

注: BigQuery データセットがアプリとは異なるプロジェクトにある場合は、CES サービス エージェント service-<PROJECT-NUMBER>@gcp-sa-ces.iam.gserviceaccount.com に roles/bigquery.admin ロールを付与する必要があります。
dataset

string

省略可。データをエクスポートする BigQuery データセット。

CloudLoggingSettings

アプリの Cloud Logging の動作を記述する設定。

JSON 表現 
{
  "enableCloudLogging": boolean
}
フィールド
enableCloudLogging

boolean

省略可。セッションで Cloud Logging を有効にするかどうか。

ConversationLoggingSettings

アプリの会話ログ記録の動作を記述する設定。

JSON 表現 
{
  "disableConversationLogging": boolean
}
フィールド
disableConversationLogging

boolean

省略可。セッションの会話ロギングを無効にするかどうか。

MetricAnalysisSettings

LLM 分析指標パイプラインの会話データ収集動作を記述する設定。

JSON 表現 
{
  "llmMetricsOptedOut": boolean
}
フィールド
llmMetricsOptedOut

boolean

省略可。llm 分析指標の会話データを収集するかどうか。true の場合、llm 分析指標の会話データは収集されません。それ以外の場合、会話データは収集されます。

ErrorHandlingSettings

アプリでエラーを処理する方法を記述する設定。

JSON 表現 
{
  "errorHandlingStrategy": enum (ErrorHandlingSettings.ErrorHandlingStrategy)
}
フィールド
errorHandlingStrategy

enum (ErrorHandlingSettings.ErrorHandlingStrategy)

省略可。エラー処理に使用する戦略。

ErrorHandlingSettings.ErrorHandlingStrategy

エラー処理の戦略を定義します。

列挙型
ERROR_HANDLING_STRATEGY_UNSPECIFIED エラー処理方式が指定されていません。デフォルトは FALLBACK_RESPONSE です。
NONE 特別な処理は有効になっていません。
FALLBACK_RESPONSE LLM エラーが発生した場合、代替メッセージがユーザーに返されます。

App.ToolExecutionMode

エージェントが同時に複数のツールを選択した場合のツール実行の動作を定義します。

列挙型
TOOL_EXECUTION_MODE_UNSPECIFIED ツールの実行モードが指定されていません。デフォルトは PARALLEL です。
PARALLEL 複数のツールが選択されている場合は、同じ ToolContext で並行して実行されます。
SEQUENTIAL 複数のツールが選択されている場合は、順番に実行されます。次のツールは、前のツールが完了した後にのみ実行され、前のツールから更新された ToolContext を確認できます。

EvaluationMetricsThresholds

評価の指標のしきい値設定。

JSON 表現 
{
  "goldenEvaluationMetricsThresholds": {
    object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds)
  },
  "hallucinationMetricBehavior": enum (EvaluationMetricsThresholds.HallucinationMetricBehavior),
  "goldenHallucinationMetricBehavior": enum (EvaluationMetricsThresholds.HallucinationMetricBehavior),
  "scenarioHallucinationMetricBehavior": enum (EvaluationMetricsThresholds.HallucinationMetricBehavior)
}
フィールド
goldenEvaluationMetricsThresholds

object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds)

省略可。ゴールデン評価指標のしきい値。
hallucinationMetricBehavior
(deprecated)

enum (EvaluationMetricsThresholds.HallucinationMetricBehavior)

省略可。非推奨: 代わりに、goldenHallucinationMetricBehavior を使用してください。現在、ハルシネーション指標の動作はゴールデン評価に使用されています。
goldenHallucinationMetricBehavior

enum (EvaluationMetricsThresholds.HallucinationMetricBehavior)

省略可。ゴールデン評価のハルシネーション指標の動作。
scenarioHallucinationMetricBehavior

enum (EvaluationMetricsThresholds.HallucinationMetricBehavior)

省略可。シナリオ評価のハルシネーション指標の動作。

EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds

ゴールデン評価の設定。

JSON 表現 
{
  "turnLevelMetricsThresholds": {
    object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds)
  },
  "expectationLevelMetricsThresholds": {
    object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.ExpectationLevelMetricsThresholds)
  },
  "toolMatchingSettings": {
    object (EvaluationMetricsThresholds.ToolMatchingSettings)
  }
}
フィールド
turnLevelMetricsThresholds

object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds)

省略可。ターンレベルの指標のしきい値。
expectationLevelMetricsThresholds

object (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.ExpectationLevelMetricsThresholds)

省略可。期待レベルの指標のしきい値。
toolMatchingSettings

object (EvaluationMetricsThresholds.ToolMatchingSettings)

省略可。ツール マッチングの設定。余分なツール呼び出しとは、実行には存在するものの、ゴールデン エクスペクテーションのツール呼び出しと一致しないツール呼び出しのことです。

EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds

レベル指標のしきい値をオンにします。

JSON 表現 
{
  "semanticSimilarityChannel": enum (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds.SemanticSimilarityChannel),
  "semanticSimilaritySuccessThreshold": integer,
  "overallToolInvocationCorrectnessThreshold": number
}
フィールド
semanticSimilarityChannel

enum (EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds.SemanticSimilarityChannel)

省略可。評価に使用する意味的類似性チャネル。
semanticSimilaritySuccessThreshold

integer

省略可。意味的類似性の成功しきい値。0 ～ 4 の整数を指定してください。デフォルトは 3 以上です。
overallToolInvocationCorrectnessThreshold

number

省略可。ツール呼び出しの全体的な正しさの成功しきい値。0 ～ 1 の浮動小数点数にする必要があります。デフォルトは 1.0 です。

EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.TurnLevelMetricsThresholds.SemanticSimilarityChannel

使用する意味的類似性チャネル。

列挙型
SEMANTIC_SIMILARITY_CHANNEL_UNSPECIFIED 指標が指定されていません。デフォルトは TEXT です。
TEXT テキストの意味的類似度を使用します。
AUDIO 音声の意味的類似性を使用します。

EvaluationMetricsThresholds.GoldenEvaluationMetricsThresholds.ExpectationLevelMetricsThresholds

期待レベルの指標のしきい値。

JSON 表現 
{
  "toolInvocationParameterCorrectnessThreshold": number
}
フィールド
toolInvocationParameterCorrectnessThreshold

number

省略可。個々のツール呼び出しパラメータの正しさの成功しきい値。0 ～ 1 の浮動小数点数にする必要があります。デフォルトは 1.0 です。

EvaluationMetricsThresholds.ToolMatchingSettings

ツール呼び出しのマッチングの設定。

JSON 表現 
{
  "extraToolCallBehavior": enum (EvaluationMetricsThresholds.ToolMatchingSettings.ExtraToolCallBehavior)
}
フィールド
extraToolCallBehavior

enum (EvaluationMetricsThresholds.ToolMatchingSettings.ExtraToolCallBehavior)

省略可。追加のツール呼び出しの動作。デフォルトは FAIL です。

EvaluationMetricsThresholds.ToolMatchingSettings.ExtraToolCallBehavior

追加のツール呼び出しが発生した場合の動作を定義します。余分なツール呼び出しとは、実行には存在するものの、ゴールデン エクスペクテーションのツール呼び出しと一致しないツール呼び出しのことです。

列挙型
EXTRA_TOOL_CALL_BEHAVIOR_UNSPECIFIED 動作は指定されていません。デフォルトは FAIL です。
FAIL 余分なツール呼び出しが発生した場合は、評価を失敗させます。
ALLOW 追加のツール呼び出しを許可します。

EvaluationMetricsThresholds.HallucinationMetricBehavior

ハルシネーション指標の動作。動作に関係なく、指標は常に計算されます。無効にすると、指標が総合評価スコアの計算に使用されなくなる点が異なります。

列挙型
HALLUCINATION_METRIC_BEHAVIOR_UNSPECIFIED ハルシネーション指標の動作が指定されていません。
DISABLED ハルシネーション指標を無効にします。
ENABLED ハルシネーション指標を有効にします。

App.VariableDeclaration

変数の構造とメタデータを定義します。

JSON 表現 
{
  "name": string,
  "description": string,
  "schema": {
    object (Schema)
  }
}
フィールド
name

string

必須。変数の名前。名前の先頭は英字またはアンダースコアにする必要があります。使用できる文字は、英字、数字、アンダースコアのみです。
description

string

必須。変数の説明。
schema

object (Schema)

必須。変数のスキーマ。

DataStoreSettings

アプリのデータストア関連の設定。

JSON 表現 
{
  "engines": [
    {
      object (DataStoreSettings.Engine)
    }
  ]
}
フィールド
engines[]

object (DataStoreSettings.Engine)

出力専用。アプリのエンジン。

DataStoreSettings.Engine

データストアが接続されているエンジン。Vertex AI Search をご覧ください: https://cloud.google.com/generative-ai-app-builder/docs/enterprise-search-introduction。

JSON 表現 
{
  "name": string,
  "type": enum (DataStoreSettings.Engine.Type)
}
フィールド
name

string

出力専用。エンジンのリソース名。形式: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}
type

enum (DataStoreSettings.Engine.Type)

出力専用。エンジンの種類。

DataStoreSettings.Engine.Type

エンジンの種類。https://cloud.google.com/generative-ai-app-builder/docs/reference/rest/v1/SolutionType と https://cloud.google.com/generative-ai-app-builder/docs/create-datastore-ingest で入手可能なドキュメントをご覧ください。

列挙型
TYPE_UNSPECIFIED エンジンタイプが指定されていません。
ENGINE_TYPE_CHAT チャット エンジンのタイプ。アプリの SOLUTION_TYPE_CHAT エンジン。アプリに追加されたすべてのコネクタ データストアがこのエンジンに追加されます。

ClientCertificateSettings

カスタム クライアント証明書の設定。

JSON 表現 
{
  "tlsCertificate": string,
  "privateKey": string,
  "passphrase": string
}
フィールド
tlsCertificate

string

必須。PEM 形式でエンコードされた TLS 証明書。この文字列には、開始ヘッダー行と終了フッター行を含める必要があります。
privateKey

string

必須。PEM 形式でエンコードされた秘密鍵を保存する SecretManager シークレット バージョン リソースの名前。形式: projects/{project}/secrets/{secret}/versions/{version}
passphrase

string

省略可。秘密鍵を復号するためのパスフレーズを保存する SecretManager シークレット バージョン リソースの名前。秘密鍵が暗号化されていない場合は、設定しないでください。形式: projects/{project}/secrets/{secret}/versions/{version}

メソッド

create

 指定されたプロジェクトとロケーションに新しいアプリを作成します。

delete

 指定されたアプリを削除します。

executeTool

 指定された引数を使用して、指定されたツールを実行します。

exportApp

 指定されたアプリをエクスポートします。

get

 指定されたアプリの詳細を取得します。

importApp

 指定されたアプリをインポートします。

list

 指定されたプロジェクトとロケーションのアプリを一覧表示します。

patch

 指定されたアプリを更新します。

retrieveToolSchema

 指定されたツールのスキーマを取得します。