프로젝트 수준 메모리 서버 구성(탐색, 추출, 스냅샷 설정)을 저장합니다. 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다. 다음 메모리 구성 동기화 후에 적용됩니다.
body
필수 사항
입력된 JSON 구성
-
용량은 이 프로젝트 에 대한 메모리 서버의 복제본 수를 설정합니다. 인프라 전용: 메모리 서버 컨테이너 자체에 마운트되지 않습니다.
-
CustomMemoryTypes는 메모리 서버 프로비저닝하는 사용자 정의 메모리 유형을 선언합니다. 만들기 전용: 게이트웨이가 이전에 수락된 선언의 편집 또는 제거를 거부합니다. 개수 제한은 구조체 태그를 지정하다 아닌 ValidateCustomMemoryTypes에 의해 적용되므로 상수는 단일 진실 소스로 유지됩니다. 바인딩:'max' 태그를 지정하다 문서 전용인 경우 — 핸들러가 진 바인딩이 아닌 json.Decoder로 디코딩하므로 런타임 효과가 없습니다. 이는 생성된 OpenAPI 사양의 제한을 표면화하기 위한 목적으로만 존재합니다.
요소가
5개 이하입니다. -
LogLevel은 프로젝트 의 메모리 서버 루트 로그 수준을 설정합니다. 디버그, 정보, 경고, 오류, 중요 중 하나입니다. 서버 기본값 (정보)을 그대로 두려면 필드 생략합니다. 명시적인 빈 문자열은 거부됩니다.
값은
debug,info,warning,error또는critical입니다. -
MetadataPartitionIndex는 범위 내 메모리 유형별로 'vector', 'text' 또는 'both' 중 파티션 필터하다 필드를 포함하는 검색 인덱스 레그를 선택합니다. 맵에서 생략된 유형은 기본값으로 벡터 구간만 사용합니다. 자유롭게 변경 가능 — 새로 프로비저닝된 인덱스가 가져오는 레그에만 영향을 미칩니다.
-
MetadataPartitionKey는 모든 범위 내 메모리 유형(의미론적, 일시적, 절차적, 단기)이 인덱싱하는 필터링 가능한 메타데이터 속성을 파티션 필터하다 필드 로 선언합니다. 생성 전용: 게이트웨이가 이전에 수락한 키의 제거 또는 재입력을 거부합니다(추가는 허용됨). 개수 제한은 구조체 태그를 지정하다 아닌 ValidateMetadataPartition에 의해 적용되므로 상수는 단일 진실 소스로 유지됩니다. 바인딩:'max' 태그를 지정하다 문서 전용인 경우 — 핸들러가 진 바인딩이 아닌 json.Decoder로 디코딩하므로 런타임 효과가 없습니다. 이는 오로지 OpenAPI 사양의 제한 사항을 표면화하기 위해 존재합니다.
요소가
10개 이하입니다. -
작업은 메모리 서버의 배경 작업 처리 조정합니다.
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
}