コンテンツへスキップ
← Back to Docs

スコープ

スコープは、同一のソース値がどこで同一の仮名に解決されるかを決定します。

存在理由

アーキテクチャのユースケースが異なれば、アイデンティティの永続性に対する要件も異なります。 単一のチケットを要約する LLM には、その 1 つのチケット内での ID の一貫性のみが必要です。 顧客離れを 1 年にわたって追跡する分析ウェアハウスでは、数か月にわたる数百万のイベントにわたる ID の一貫性が必要です。

正確な動作

スコープ = リクエスト (デフォルト)

ID は単一の HTTP API 呼び出し内でのみ一貫性があります。 メモリ マッピングは、応答が返された直後に破棄されます。

Request A
Alice → PERSON_01

Request B
Alice → PERSON_01? NO (Could be PERSON_01, PERSON_03, etc., depending on appearance order in Request B)

スコープ = プロジェクト (近日公開予定)

ID は、同じプロジェクトに属する API キーを使用して行われたすべてのリクエストにわたって無期限に安定したままになります。 これは、プロジェクト構成に関連付けられた安定した 決定キー に依存します。

Request A
Alice → PERSON_7CX2

Request B (Next day)
Alice → PERSON_7CX2

APIパラメータ

{
  "policy": {
    "scope": "request" // default
  }
}