Reconstruye el contexto de la conversación a partir de la memoria (fuentes predeterminadas: episódica, semántica; incluya stm en enabled_sources para los turnos recientes). El ámbito del proyecto se define mediante el parámetro de ruta id y la organización se deriva de dicho proyecto. Proporcione una consulta no vacía (normalmente el último mensaje del usuario) y el user_id cuya memoria se desea reconstruir.
Cuerpo
Requerido
Solicitud de compilación de contexto
-
EnabledSources selecciona las fuentes de memoria (stm, episódica, semántica, taxonómica, procedimental); si se omite, se utilizan por defecto episódica y semántica.
-
MaxTokens es el presupuesto bruto para la construcción del contexto (no un costo de recuperación). Tras la recuperación y la clasificación, el servidor de memoria resta una reserva de formato de token 500 y, a continuación, selecciona de forma voraz bloques de memoria completos que se ajusten. Los valores positivos iguales o inferiores a 500 no dejan presupuesto para memorias. Los valores superiores a 500 aún pueden generar un contexto vacío cuando ningún bloque se ajusta.
El valor mínimo es
1. -
Se permiten propiedades adicionales.
-
El valor mínimo es
1, el valor máximo es200.
Respuestas
-
Versión de API no compatible o con formato incorrecto, operación no disponible en el contrato publicado seleccionado o representación inaceptable (incluidos parámetros de tipo de medio no compatibles o SSE excluidos). Los fallos de autenticación, autorización y límite de velocidad existentes tienen prioridad.
-
Carga útil de contexto ensamblada
-
Cuerpo de solicitud no válido, falta user_id/query o top_k fuera de 1-200
-
Credenciales faltantes o no válidas
-
La persona que llama no tiene permisos de lectura para el proyecto.
-
Error interno
-
Servicio de memoria inaccesible
curl \
--request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/memory/context' \
--header "Authorization: $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"enabled_sources": [
"string"
],
"format_style": "string",
"include_memories": true,
"max_tokens": 42,
"metadata_filter": {},
"model_type": "string",
"query": "string",
"query_embedding": [
42.0
],
"session_id": "string",
"similarity_threshold": 42.0,
"top_k": 42,
"user_id": "string",
"visibility": "string"
}'{
"enabled_sources": [
"string"
],
"format_style": "string",
"include_memories": true,
"max_tokens": 42,
"metadata_filter": {},
"model_type": "string",
"query": "string",
"query_embedding": [
42.0
],
"session_id": "string",
"similarity_threshold": 42.0,
"top_k": 42,
"user_id": "string",
"visibility": "string"
}{
"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"
}{
"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"
}{}{}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}{
"code": "string",
"error": "string",
"success": true
}