ソースごとの仕様から対話コンテキストを構築

POST /api/v1/projects/{id}/memory/retryval/context-from-sources

明示的なソースごとに構成されたソースのセットから対話コンテキストを集約します。各ソースは、独自の検索モード(テキスト、セマンティック、ハイブリッド)、メタデータフィルター、および候補数を宣言します。結果はソース間でマージされ重複が除外され、オプションで再ランク付けされ、 build_context のように形式設定され、予算化されます。プロジェクトスコープは ルート ID パス パラメーターによって保持され、 組織はそのプロジェクトから派生します。空でないクエリ、アセンブルするメモリを持つ user_id、および空でないソース リストを指定します。

path パラメータ

  • id string 必須

    プロジェクトID

application/ JSON

body 必須

ソースごとのコンテキスト構築リクエスト

  • 形式_スタイル string
  • include_memory ブール値
  • max_tokens integer

    MaxTokens は、 build_context のように解釈される、コンテキスト構築の全体的コスト( fetchコストではない)です。サーバーは500 トークンの形式予約を減算し、 に収まるメモリ チャンク全体を積極的に選択します。

    の最小値は 1 です。

  • model_type string
  • クエリ string 必須
  • query_ embedded array[number]
  • rerank ブール値

    Rerank は、マージされた結果を関連性の高い再ランクで並べ替えます(使用可能な場合)。

  • Session_id string
  • ソース array[オブジェクト] 必須

    ソースは、検索するための明示的なソースごとのセットです。メモリサーバーはカウント限界(1..MAX_CONNECT2_SOURCES)、各ソースの op_k 限界、および重複ソース ルールを強制します。

    ソース属性を非表示にする ソース属性の表示 オブジェクト
    • metadata_filter オブジェクト

      追加のプロパティが許可されます。

    • モード string
    • ソース string 必須
    • top_k integer
  • user_id string 必須
  • 可視性 string

応答

  • サポートされていないAPIバージョンまたは不正な API バージョン、選択した公開契約で利用できない操作、または受け入れができない表現(サポートされていないメディアタイプのパラメーター、または除外された SSE を含む)。既存の認証、認可、およびレート制限の失敗が優先されます。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエート エラーでは、このフィールドは出力されません。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        検証に失敗したフィールド。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト

        フィールドとその検証の失敗。

        • 説明 string 必須

          人間が判読できる検証の失敗。

        • フィールド string 必須

          無効なリクエストフィールドの名前またはパス。

    • 詳細 string 必須

      人間が判読できるエラーの詳細。

    • エラー integer 必須

      HTTP status code.

    • errorCode string 必須

      マシンが判読できるエラー コード。

    • パラメーター array[string]

      エラーに関連付けられたリクエスト パラメータ名。該当しない場合は省略します。

    • 理由 string 必須

      HTTPステータス理由フレーズ。

    応答属性の非表示 応答属性の表示 オブジェクト
    • validRequestDetail オブジェクト

      標準エラースキーマによって定義される任意の検証の詳細。 APIネゴシエート エラーでは、このフィールドは出力されません。

      validRequestDetail 属性を非表示にする validRequestDetail 属性の表示 オブジェクト
      • フィールド array[オブジェクト]

        検証に失敗したフィールド。

        フィールド属性を非表示にする フィールド属性の表示 オブジェクト

        フィールドとその検証の失敗。

        • 説明 string 必須

          人間が判読できる検証の失敗。

        • フィールド string 必須

          無効なリクエストフィールドの名前またはパス。

    • 詳細 string 必須

      人間が判読できるエラーの詳細。

    • エラー integer 必須

      HTTP status code.

    • errorCode string 必須

      マシンが判読できるエラー コード。

    • パラメーター array[string]

      エラーに関連付けられたリクエスト パラメータ名。該当しない場合は省略します。

    • 理由 string 必須

      HTTPステータス理由フレーズ。

  • 200

    ソースごとのメタデータと集約されたコンテキストのペイロード

  • 400

    リクエスト本文が無効であるか、user_id/query/source が欠落しています

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 401

    認証情報が欠落しているか無効である

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 403

    呼び出し元にはプロジェクトへの読み取りアクセス権がありません

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 500

    内部エラー

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
  • 502

    メモリ サービスにアクセスできません

    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
    応答属性の非表示 応答属性の表示 オブジェクト
    • コード string
    • エラー string
    • 成功 ブール値
POST /api/v1 /projects/{id}/memory/retryval/context-from-sources
curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/memory/retrieval/context-from-sources' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "format_style": "string",
  "include_memories": true,
  "max_tokens": 42,
  "model_type": "string",
  "query": "string",
  "query_embedding": [
    42.0
  ],
  "rerank": true,
  "session_id": "string",
  "sources": [
    {
      "metadata_filter": {},
      "mode": "string",
      "source": "string",
      "top_k": 42
    }
  ],
  "user_id": "string",
  "visibility": "string"
}'
リクエスト例
{
  "format_style": "string",
  "include_memories": true,
  "max_tokens": 42,
  "model_type": "string",
  "query": "string",
  "query_embedding": [
    42.0
  ],
  "rerank": true,
  "session_id": "string",
  "sources": [
    {
      "metadata_filter": {},
      "mode": "string",
      "source": "string",
      "top_k": 42
    }
  ],
  "user_id": "string",
  "visibility": "string"
}
応答の例(406)
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
応答の例(406)
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
応答の例(200)
{}
応答の例(200)
{}
応答の例(400)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(400)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(401)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(401)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(403)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(403)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(500)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(500)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(502)
{
  "code": "string",
  "error": "string",
  "success": true
}
応答の例(502)
{
  "code": "string",
  "error": "string",
  "success": true
}