プロジェクトレベルのメモリサーバー構成（ストレージ、抽出、スナップショット設定）を保存します。プロジェクトスコープは ルート ID パス パラメーターによって保持され、 組織はそのプロジェクトから派生します。次回のメモリ構成同期後に有効になります。
body
必須
型指定されたJSON構成
-
容量は、このプロジェクトのメモリサーバーのレプリカ数を設定します。インフラストラクチャのみ: メモリサーバーコンテナ自体にはマウントされません。
-
CustomMemoryTypes は、メモリサーバーがプロビジョニングするユーザー定義のメモリ型を宣言します。作成専用: ゲートウェイは以前に受け入れられた宣言の編集または削除を拒否します。カウント制限は、構造体タグではなくValidatecustomMemoryTypes によって適用されるため、定数は真実の単一ソースのままになります。バインディング: "max"タグはドキュメントのみに含まれます。ハンドラーは Git バインディングではなく json.Decoder でデコードされるため、ランタイム効果はありません。生成された OpenAPI 仕様の制限を表示するためにのみ存在します。
5要素以下 -
LogLevel は、プロジェクトのメモリサーバーのルートログレベルを設定します。デバッグ、情報、警告、エラー、クリティカルのいずれか 1 つ。サーバーのデフォルト（情報）のままにするには、フィールドを省略します。明示的な空の文字列は拒否されます。
値は、
debug、info、warning、error、またはcriticalです。 -
MetadataPartitionIndex は、スコープ内のメモリ型ごとに、パーティション フィルター フィールドを実行する検索インデックスラグを選択します。マップから省略された 型のデフォルトはベクトルレプリカのみです。自由に変更可能 - これは新しくプロビジョニングされたインデックスが取得するリージョンにのみ影響します。
-
MetadataPartitionKey は、スコープ内のすべてのメタデータ型（セマンティック、エポック、手順書込み、短縮_ターム）インデックスを パーティション フィルターフィールドとして宣言します。作成専用: ゲートウェイは以前に受け入れられたキーの削除または再入力を拒否します（追加は許可されます）。カウント制限は、構造体タグではなくValidateMetadataPartitionによって強制されるため、定数は真実の単一ソースのままになります。バインディング: "max"タグはドキュメントのみに含まれます。ハンドラーは Git バインディングではなく json.Decoder でデコードされるため、ランタイム効果はありません。 OpenAPI 仕様の制限を表示するためにのみ存在します。
10要素以下 -
Tasks は、メモリ サーバーのバックグラウンドタスク処理を調整します。
PUT /api/v1 /projects/{id}/memory/config
curl \
--request PUT 'https://agentengine.mongodb.com/api/v1/projects/{id}/memory/config' \
--header "Authorization: $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"background_extraction": {
"snapshot": {
"delete_promoted": true,
"embed_stm_before_promotion": true,
"max_messages": 42,
"stale_minutes": 42,
"topic_shift_enabled": true,
"topic_shift_threshold": 42.0,
"ttl_days": 42
}
},
"capacity": {
"max_replicas": 42,
"min_replicas": 42
},
"custom_memory_types": [
{
"collection": "string",
"name": "string",
"tags": [
{
"name": "string"
}
]
}
],
"extraction": {
"enabled": [
"string"
],
"episodic": {
"prompt": "string"
},
"preferences": {
"prompt": "string"
},
"procedural": {
"prompt": "string"
},
"semantic": {
"prompt": "string"
},
"taxonomic": {
"prompt": "string"
}
},
"extraction_llm": {
"api_key_secret": "LLM_API_KEY",
"auth_header": "authorization",
"base_url": "string",
"model": "string",
"provider": "openai"
},
"log_level": "debug",
"metadata_partition_index": {
"additionalProperty1": [
"string"
],
"additionalProperty2": [
"string"
]
},
"metadata_partition_key": [
{
"name": "string",
"type": "string"
}
],
"short_term": {
"embed_on_write": true
},
"tasks": {
"legacy_retry": true
},
"voyage": {
"dimension": 42,
"model": "string"
}
}'
リクエスト例
{
"background_extraction": {
"snapshot": {
"delete_promoted": true,
"embed_stm_before_promotion": true,
"max_messages": 42,
"stale_minutes": 42,
"topic_shift_enabled": true,
"topic_shift_threshold": 42.0,
"ttl_days": 42
}
},
"capacity": {
"max_replicas": 42,
"min_replicas": 42
},
"custom_memory_types": [
{
"collection": "string",
"name": "string",
"tags": [
{
"name": "string"
}
]
}
],
"extraction": {
"enabled": [
"string"
],
"episodic": {
"prompt": "string"
},
"preferences": {
"prompt": "string"
},
"procedural": {
"prompt": "string"
},
"semantic": {
"prompt": "string"
},
"taxonomic": {
"prompt": "string"
}
},
"extraction_llm": {
"api_key_secret": "LLM_API_KEY",
"auth_header": "authorization",
"base_url": "string",
"model": "string",
"provider": "openai"
},
"log_level": "debug",
"metadata_partition_index": {
"additionalProperty1": [
"string"
],
"additionalProperty2": [
"string"
]
},
"metadata_partition_key": [
{
"name": "string",
"type": "string"
}
],
"short_term": {
"embed_on_write": true
},
"tasks": {
"legacy_retry": true
},
"voyage": {
"dimension": 42,
"model": "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）
{
"config": {
"background_extraction": {
"snapshot": {
"delete_promoted": true,
"embed_stm_before_promotion": true,
"max_messages": 42,
"stale_minutes": 42,
"topic_shift_enabled": true,
"topic_shift_threshold": 42.0,
"ttl_days": 42
}
},
"capacity": {
"max_replicas": 42,
"min_replicas": 42
},
"custom_memory_types": [
{
"collection": "string",
"name": "string",
"tags": [
{
"name": "string"
}
]
}
],
"extraction": {
"enabled": [
"string"
],
"episodic": {
"prompt": "string"
},
"preferences": {
"prompt": "string"
},
"procedural": {
"prompt": "string"
},
"semantic": {
"prompt": "string"
},
"taxonomic": {
"prompt": "string"
}
},
"extraction_llm": {
"api_key_secret": "LLM_API_KEY",
"auth_header": "authorization",
"base_url": "string",
"model": "string",
"provider": "openai"
},
"log_level": "debug",
"metadata_partition_index": {
"additionalProperty1": [
"string"
],
"additionalProperty2": [
"string"
]
},
"metadata_partition_key": [
{
"name": "string",
"type": "string"
}
],
"short_term": {
"embed_on_write": true
},
"tasks": {
"legacy_retry": true
},
"voyage": {
"dimension": 42,
"model": "string"
}
},
"generation": 42,
"updated_at": "string"
}
応答の例（200）
{
"config": {
"background_extraction": {
"snapshot": {
"delete_promoted": true,
"embed_stm_before_promotion": true,
"max_messages": 42,
"stale_minutes": 42,
"topic_shift_enabled": true,
"topic_shift_threshold": 42.0,
"ttl_days": 42
}
},
"capacity": {
"max_replicas": 42,
"min_replicas": 42
},
"custom_memory_types": [
{
"collection": "string",
"name": "string",
"tags": [
{
"name": "string"
}
]
}
],
"extraction": {
"enabled": [
"string"
],
"episodic": {
"prompt": "string"
},
"preferences": {
"prompt": "string"
},
"procedural": {
"prompt": "string"
},
"semantic": {
"prompt": "string"
},
"taxonomic": {
"prompt": "string"
}
},
"extraction_llm": {
"api_key_secret": "LLM_API_KEY",
"auth_header": "authorization",
"base_url": "string",
"model": "string",
"provider": "openai"
},
"log_level": "debug",
"metadata_partition_index": {
"additionalProperty1": [
"string"
],
"additionalProperty2": [
"string"
]
},
"metadata_partition_key": [
{
"name": "string",
"type": "string"
}
],
"short_term": {
"embed_on_write": true
},
"tasks": {
"legacy_retry": true
},
"voyage": {
"dimension": 42,
"model": "string"
}
},
"generation": 42,
"updated_at": "string"
}
応答の例（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
}
応答の例（413）
{
"code": "string",
"error": "string",
"success": true
}
応答の例（413）
{
"code": "string",
"error": "string",
"success": true
}