Construye el contexto de la conversación a partir de las especificaciones de cada fuente.

publicación /api/v1/projects/{id}/memory/retrieval/context-from-sources
Autorización del portador

Recopila el contexto de la conversación a partir de un conjunto explícito de fuentes configuradas por fuente: cada fuente declara su propio modo de recuperación (texto, semántico, híbrido), filtro de metadatos y recuento de candidatos. Los resultados se combinan y se eliminan los duplicados de todas las fuentes, se reordenan opcionalmente y luego se formatean y se les asigna un presupuesto como en build_context. El alcance del proyecto se define mediante el parámetro de ruta id y la organización se deriva de ese proyecto. Proporcione una consulta no vacía, el user_id cuya memoria se va a recopilar y una lista de fuentes no vacía.

Parámetros de path

  • ID string Requerido

    ID del proyecto

application/json

Cuerpo Requerido

Solicitud de compilación de contexto por fuente

  • estilo_de_formato string
  • incluir_recuerdos booleano
  • max_tokens entero

    MaxTokens es el presupuesto bruto de construcción de contexto (no un costo de obtención), interpretado como build_context: el servidor resta una reserva de formato de token 500, luego selecciona de forma voraz bloques de memoria completos que se ajusten.

    El valor mínimo es 1.

  • model_type string
  • Consulta string Requerido
  • incrustación de consulta matriz[número]
  • reclasificar booleano

    La función Rerank reordena los resultados combinados según su relevancia, cuando esté disponible.

  • session_id string
  • fuentes arreglo[objeto] Requerido

    Sources es el conjunto explícito, configurado por fuente, para realizar la búsqueda; el servidor de memoria aplica los límites de conteo (1..MAX_CONTEXT2_SOURCES), los límites top_k de cada fuente y la regla de no duplicación de fuentes.

    Ocultar atributos de fuentes Mostrar atributos de las fuentes Objeto
    • metadata_filter Objeto

      Se permiten propiedades adicionales.

    • moda string
    • Origen string Requerido
    • top_k entero
  • user_id string Requerido
  • visibilidad string

Respuestas

  • 406

    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.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • badRequestDetail Objeto

      Detalles de validación opcionales definidos por el esquema de error estándar; los errores de negociación de la API no emiten este campo.

      Ocultad el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
      • Campos arreglo[objeto]

        Campos con errores de validación.

        Ocultar campos atributos Mostrar los atributos de los campos Objeto

        Un campo y su fallo de validación.

        • Descripción string Requerido

          Fallo en la validación legible para humanos.

        • Campo string Requerido

          Nombre o ruta del campo de solicitud no válido.

    • detalle string Requerido

      Detalles de errores legibles para humanos.

    • Error entero Requerido

      HTTP status code.

    • errorCode string Requerido

      Código de error legible por máquina.

    • Parámetros array[string]

      Nombres de los parámetros de la solicitud asociados con el error; se omiten cuando no corresponde ninguno.

    • motivo string Requerido

      Frase que indica el motivo del estado HTTP.
  • 200

    Carga útil de contexto ensamblada con metadatos por fuente
  • 400

    Cuerpo de solicitud no válido o falta user_id/query/sources.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 401

    Credenciales faltantes o no válidas

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 403

    La persona que llama no tiene permisos de lectura para el proyecto.

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 500

    Error interno

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
  • 502

    Servicio de memoria inaccesible

    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
    Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
    • Código string
    • Error string
    • éxito booleano
POST /api/v1/projects/{id}/memory/retrieval/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"
}'
Solicitar ejemplos 
{
  "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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (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"
}
Ejemplos de respuesta (200) 
{}
Ejemplos de respuesta (200) 
{}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (403) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Ejemplos de respuesta (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}