REST Resource: projects.locations.collections.engines

リソース: Engine

Engine のトレーニング パラメータとサービング パラメータを記述するメタデータ。

JSON 表現 
{
  "name": string,
  "displayName": string,
  "createTime": string,
  "updateTime": string,
  "dataStoreIds": [
    string
  ],
  "solutionType": enum (SolutionType),
  "industryVertical": enum (IndustryVertical),
  "commonConfig": {
    object (CommonConfig)
  },
  "appType": enum (AppType),
  "disableAnalytics": boolean,
  "features": {
    string: enum (FeatureState),
    ...
  },
  "configurableBillingApproach": enum (ConfigurableBillingApproach),

  // Union field engine_config can be only one of the following:
  "similarDocumentsConfig": {
    object (SimilarDocumentsEngineConfig)
  },
  "chatEngineConfig": {
    object (ChatEngineConfig)
  },
  "searchEngineConfig": {
    object (SearchEngineConfig)
  },
  "mediaRecommendationEngineConfig": {
    object (MediaRecommendationEngineConfig)
  }
  // End of list of possible types for union field engine_config.

  // Union field engine_metadata can be only one of the following:
  "recommendationMetadata": {
    object (RecommendationMetadata)
  },
  "chatEngineMetadata": {
    object (ChatEngineMetadata)
  }
  // End of list of possible types for union field engine_metadata.
}
フィールド
name

string

変更不可。ID。エンジンの完全修飾リソース名。

このフィールドは、長さの上限が 1,024 文字の UTF-8 でエンコードされた文字列にする必要があります。

形式: projects/{project}/locations/{location}/collections/{collection}/engines/{engine} エンジンは 1 ～ 63 文字で、有効な文字は /[a-z0-9][a-z0-9-_]*/ です。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。
displayName

string

必須。エンジンの表示名。人間が読めるようにする必要があります。UTF-8 でエンコードされた文字列で、上限は 1,024 文字です。
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)

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

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"。
dataStoreIds[]

string

省略可。このエンジンに関連付けられているデータストア。

SOLUTION_TYPE_SEARCH タイプと SOLUTION_TYPE_RECOMMENDATION タイプのエンジンは、最大で 1 つのデータストアにのみ関連付けることができます。

solutionType が SOLUTION_TYPE_CHAT の場合、同じ Collection 内の複数の DataStore をここに関連付けることができます。

CreateEngineRequest で使用する場合、システムが初期化に必要な処理で使用するため、DataStore ID を 1 つ指定する必要があります。
solutionType

enum (SolutionType)

必須。エンジンのソリューション。
industryVertical

enum (IndustryVertical)

省略可。エンジンが登録する業種。Engine 業種の制限は、DataStore に基づいています。Engine の業種は、Engine にリンクされている DataStore の業種と一致する必要があります。
commonConfig

object (CommonConfig)

エンジンのメタデータを指定する共通構成仕様。
appType

enum (AppType)

省略可。変更不可。このエンジン リソースが表すアプリケーション タイプ。注: これは、既存の業界の業種やソリューション タイプとは無関係の新しいコンセプトです。
disableAnalytics

boolean

省略可。このエンジンで行われた検索のアナリティクスを無効にするかどうか。
features

map (key: string, value: enum (FeatureState))

省略可。エンジンが機能をオプトインまたはオプトアウトするための機能構成。サポートされているキー:

  • *: すべての対象物。この値が存在する場合、他のすべての対象物の状態設定は無視されます。
  • agent-gallery
  • no-code-agent-builder
  • prompt-gallery
  • model-selector
  • notebook-lm
  • people-search
  • people-search-org-chart
  • bi-directional-audio
  • feedback
  • session-sharing
  • personalization-memory
  • disable-agent-sharing
  • disable-image-generation
  • disable-video-generation
  • disable-onedrive-upload
  • disable-talk-to-content
  • disable-google-drive-upload
configurableBillingApproach

enum (ConfigurableBillingApproach)

省略可。構成可能な課金アプローチの構成。
共用体フィールド engine_config。エンジンの動作を定義する追加の構成仕様。engine_config は次のいずれかになります。
similarDocumentsConfig

object (SimilarDocumentsEngineConfig)

similar-items エンジンの追加の構成仕様。
chatEngineConfig

object (ChatEngineConfig)

Chat Engine の構成。solutionType が SOLUTION_TYPE_CHAT の場合にのみ適用されます。
searchEngineConfig

object (SearchEngineConfig)

検索エンジンの構成。solutionType が SOLUTION_TYPE_SEARCH の場合にのみ適用されます。
mediaRecommendationEngineConfig

object (MediaRecommendationEngineConfig)

Media Engine の構成。solutionType、SOLUTION_TYPE_RECOMMENDATION、IndustryVertical.MEDIA の業種を含むデータストアにのみ適用されます。
共用体フィールド engine_metadata。エンジンのステータスをモニタリングするエンジン メタデータ。engine_metadata は次のいずれかになります。
recommendationMetadata

object (RecommendationMetadata)

出力専用。レコメンデーション エンジンの追加情報。solutionType が SOLUTION_TYPE_RECOMMENDATION の場合にのみ適用されます。
chatEngineMetadata

object (ChatEngineMetadata)

出力専用。Chat Engine の追加情報。solutionType が SOLUTION_TYPE_CHAT の場合にのみ適用されます。

SimilarDocumentsEngineConfig

この型にはフィールドがありません。

similar-items エンジンの追加の構成仕様。

ChatEngineConfig

Chat Engine の構成。

JSON 表現 
{
  "agentCreationConfig": {
    object (AgentCreationConfig)
  },
  "dialogflowAgentToLink": string,
  "allowCrossRegion": boolean
}
フィールド
agentCreationConfig

object (AgentCreationConfig)

この構成により、この Engine に関連付けられた Dialogflow エージェントが生成されます。

これらの構成は、Dialogflow サービスによって 1 回だけ使用され、渡されます。つまり、エンジン作成後に EngineService.GetEngine API または EngineService.ListEngines API を使用して取得することはできません。
allowCrossRegion

boolean

省略可。フラグが true に設定されている場合、エージェントとエンジンが異なるロケーションにあることが許可されます。それ以外の場合、エージェントとエンジンは同じロケーションにある必要があります。このフラグはデフォルトで false に設定されています。

allowCrossRegion は 1 回だけ使用され、EngineService.CreateEngine に渡されます。つまり、エンジン作成後に EngineService.GetEngine API または EngineService.ListEngines API を使用して取得することはできません。

AgentCreationConfig

Dialogflow エージェントを生成するための構成。

これらの構成は、Dialogflow サービスによって 1 回だけ使用され、渡されます。つまり、エンジン作成後に EngineService.GetEngine API または EngineService.ListEngines API を使用して取得することはできません。

JSON 表現 
{
  "business": string,
  "defaultLanguageCode": string,
  "timeZone": string,
  "location": string
}
フィールド
business

string

エージェントが代理人を務める会社、組織、その他の団体の名前。ナレッジ コネクタの LLM プロンプトとナレッジ検索に使用されます。
defaultLanguageCode

string

必須。エージェントのデフォルト言語。言語タグとして使用されます。現在サポートされている言語コードのリストについては、言語のサポートをご覧ください。
timeZone

string

必須。タイムゾーン データベースにあるエージェントのタイムゾーン（例: America/New_York、Europe/Paris）。
location

string

エージェント作成のエージェントのロケーション。サポートされている値は global、us、eu です。指定しない場合、us Engine はデフォルトで us-central-1 を使用してエージェントを作成し、eu Engine はデフォルトで eu-west-1 を使用してエージェントを作成します。

SearchEngineConfig

検索エンジンの構成。

JSON 表現 
{
  "searchTier": enum (SearchTier),
  "searchAddOns": [
    enum (SearchAddOn)
  ]
}
フィールド
searchTier

enum (SearchTier)

このエンジンの検索機能の階層。

プランによって料金が異なる場合があります。詳細については、料金に関するドキュメントをご覧ください。

指定しない場合のデフォルトは SearchTier.SEARCH_TIER_STANDARD です。
searchAddOns[]

enum (SearchAddOn)

この検索エンジンが有効にするアドオン。

SearchTier

検索機能の階層。プランによって料金が異なる場合があります。詳細については、料金に関するドキュメントをご覧ください。

列挙型
SEARCH_TIER_UNSPECIFIED 列挙型が指定されていない場合のデフォルト値。これは使用できません。
SEARCH_TIER_STANDARD スタンダード ティア。
SEARCH_TIER_ENTERPRISE エンタープライズ ティア。

SearchAddOn

検索に追加機能を提供するアドオン。

列挙型
SEARCH_ADD_ON_UNSPECIFIED 列挙型が指定されていない場合のデフォルト値。これは使用できません。
SEARCH_ADD_ON_LLM 大規模言語モデル アドオン。

MediaRecommendationEngineConfig

メディア レコメンデーション エンジンの追加の構成仕様。

JSON 表現 
{
  "type": string,
  "optimizationObjective": string,
  "optimizationObjectiveConfig": {
    object (OptimizationObjectiveConfig)
  },
  "trainingState": enum (TrainingState),
  "engineFeaturesConfig": {
    object (EngineFeaturesConfig)
  }
}
フィールド
type

string

必須。エンジンの種類。例: recommended-for-you。

このフィールドは optimizationObjective とともに、エンジンのトレーニングとサービングの制御に使用するエンジン メタデータを記述します。

現在サポートされている値: recommended-for-you、others-you-may-like、more-like-this、most-popular-items。
optimizationObjective

string

最適化の目標。例: cvr。

このフィールドは optimizationObjective とともに、エンジンのトレーニングとサービングの制御に使用するエンジン メタデータを記述します。

現在サポートされている値: ctr、cvr。

指定しない場合、エンジンタイプに基づいてデフォルトが選択されます。デフォルトは推奨事項のタイプによって異なります。

recommended-for-you => ctr

others-you-may-like => ctr
optimizationObjectiveConfig

object (OptimizationObjectiveConfig)

コンバージョン率の最適化目標のカスタムしきい値の名前と値。targetField watch-time の場合、target_field_value は、メディアの進行状況の時間を秒単位で示す整数値（0, 86400]（0 は除外、86400 は含む）にする必要があります（例: 90）。targetField watch-percentage の場合、target_field_value は (0, 1.0]（0 は除外、1.0 は含む）の範囲内の有効な浮動小数点値にする必要があります（例: 0.5）。
trainingState

enum (TrainingState)

エンジンが置かれているトレーニング状態（TRAINING、PAUSED など）。

サービスの実行コストの一部はトレーニングの頻度であるため、これを使用して、コストを制御するためにエンジンをトレーニングするタイミングを決定できます。指定しない場合: engines.create メソッドのデフォルト値は TRAINING です。engines.patch メソッドのデフォルト値は、状態を以前と同じに保つことです。
engineFeaturesConfig

object (EngineFeaturesConfig)

省略可。追加のエンジン機能の構成。

OptimizationObjectiveConfig

cvr optimizationObjective のカスタムしきい値。

JSON 表現 
{
  "targetField": string,
  "targetFieldValueFloat": number
}
フィールド
targetField

string

必須。ターゲットにするフィールドの名前。現在サポートされている値: watch-percentage、watch-time。
targetFieldValueFloat

number

必須。ターゲットに適用するしきい値（例: 0.5）。

TrainingState

エンジンのトレーニング状態。

列挙型
TRAINING_STATE_UNSPECIFIED トレーニングの状態が未指定。
PAUSED エンジン トレーニングは一時停止しています。
TRAINING エンジンはトレーニング中です。

EngineFeaturesConfig

選択したエンジンタイプのその他の特徴構成。

JSON 表現 
{

  // Union field type_dedicated_config can be only one of the following:
  "recommendedForYouConfig": {
    object (RecommendedForYouFeatureConfig)
  },
  "mostPopularConfig": {
    object (MostPopularFeatureConfig)
  }
  // End of list of possible types for union field type_dedicated_config.
}
Fields
共用体フィールド type_dedicated_config。特定のタイプのメディア レコメンデーション エンジンに適用される機能関連の構成。type_dedicated_config は次のいずれかになります。
recommendedForYouConfig

object (RecommendedForYouFeatureConfig)

おすすめのエンジン機能構成。

RecommendedForYouFeatureConfig

recommended-for-you エンジンを作成するための追加の機能構成。

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

string

予測時にエンジンがクエリされるイベントのタイプ。generic に設定した場合、エンジン トレーニングで context-event として使用されるのは view-item、media-play、media-complete のみです。view-home-page に設定すると、view-item、media-play、media-complete に加えて、context-events としても view-home-page が使用されます。現在、recommended-for-you エンジンでサポートされています。現在サポートされている値: view-home-page、generic。

MostPopularFeatureConfig

最も人気のあるエンジンを作成するために必要な機能構成。

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

string (int64 format)

トレーニング時と予測時にエンジンがクエリされる時間枠。正の整数のみ。この値は、イベントの過去 X 日間に変換されます。現在、most-popular-items エンジンに必要です。

RecommendationMetadata

レコメンデーション エンジンの追加情報。

JSON 表現 
{
  "servingState": enum (ServingState),
  "dataState": enum (DataState),
  "lastTuneTime": string,
  "lastTrainTime": string,
  "tuningOperation": string
}
フィールド
servingState

enum (ServingState)

出力専用。エンジンのサービング状態: ACTIVE、NOT_ACTIVE。
dataState

enum (DataState)

出力専用。このエンジンのデータ要件の状態: DATA_OK と DATA_ERROR。

データが DATA_ERROR 状態の場合、エンジンをトレーニングできません。サービング状態が ACTIVE であっても、エンジンが DATA_ERROR 状態になることがあります。これは、以前にエンジンが正常にトレーニングされたものの、基盤となるエンジンにトレーニング用の十分なデータがなくなったため、更新できなくなった場合です。
lastTuneTime

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"。
lastTrainTime

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"。
tuningOperation

string

出力専用。エンジンに関連付けられた最新のチューニング オペレーション ID。メディア レコメンデーション エンジンにのみ適用されます。

このオペレーション ID が存在する場合、このエンジンでチューニングが進行中かどうかを判断するために使用できます。オペレーションのステータスを確認するには、エンジン リソース形式でこのオペレーション ID を指定して operations.get リクエストを送信します。このエンジンでチューニングが行われていない場合、文字列は空になります。

ServingState

レコメンデーション エンジンのサービング状態。

列挙型
SERVING_STATE_UNSPECIFIED 未指定のサービング状態。
INACTIVE エンジンが配信されていません。
ACTIVE エンジンがサービング中で、クエリを実行できます。
TUNED エンジンは調整されたハイパーパラメータでトレーニングされ、クエリを実行できます。

DataState

このエンジンに継続的にトレーニングするための十分なトレーニング データがあるかどうかを説明します。

列挙型
DATA_STATE_UNSPECIFIED 未指定のデフォルト値。明示的に設定しないでください。
DATA_OK エンジンに十分なトレーニング データがある。
DATA_ERROR エンジンに十分なトレーニング データがない。エラー メッセージは Stackdriver でクエリできます。

ChatEngineMetadata

Chat Engine の追加情報。このメッセージのフィールドは出力専用です。

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

string

この Chat Engine が参照する Dialogflow エージェントのリソース名。

形式: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>。

CommonConfig

Engine の一般的な構成。

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

string

エンジンに関連付けられている会社、ビジネス、またはエンティティの名前。この設定を行うと、LLM 関連機能の改善に役立つことがあります。

AppType

エンジンのアプリ。

列挙型
APP_TYPE_UNSPECIFIED 指定されていないすべてのアプリ。
APP_TYPE_INTRANET イントラネット検索と Agentspace のアプリタイプ。

FeatureState

エンジンの機能の状態。

列挙型
FEATURE_STATE_UNSPECIFIED 機能の状態が指定されていません。
FEATURE_STATE_ON この機能は、アクセスできるようにオンになっています。
FEATURE_STATE_OFF この機能はオフになっており、アクセスできません。

ConfigurableBillingApproach

構成可能な課金アプローチの構成。

列挙型
CONFIGURABLE_BILLING_APPROACH_UNSPECIFIED デフォルト値。Spark と非 Spark の構成不可の課金アプローチの場合。一般的な料金モデル。
CONFIGURABLE_BILLING_APPROACH_ENABLED 課金方法は、お客様が指定した構成に従います。

メソッド

create

 Engine を作成します。

delete

 Engine を削除します。

get

 Engine を取得します。

getCompletionConfig

 CompletionConfig を取得します

getWorkspaceSettings

 エンドユーザーの Workspace 設定を取得します。

list

 プロジェクトに関連付けられているすべての Engine を一覧表示します。

patch

 Engine を更新します

pause

 既存のエンジンのトレーニングを一時停止します。

resume

 既存のエンジンのトレーニングを再開します。

tune

 既存のエンジンを調整します。

updateCompletionConfig

 CompletionConfig を更新します。