소스별 사양에서 대화 컨텍스트 구축

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

소스별로 구성된 명시적인 소스 설정하다 에서 대화 컨텍스트를 어셈블하며, 각 소스는 자체 검색 모드 (텍스트, 시맨틱, 하이브리드), 메타데이터 필터하다 및 후보 수를 선언합니다. 결과는 여러 소스에서 병합 및 중복 제거되며, 선택적으로 순위가 재지정된 다음 build_context와 같이 형식이 지정되고 예산이 책정됩니다. 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다. 비어 있지 않은 쿼리, 메모리를 어셈블할 메모리의 user_id, 비어 있지 않은 소스 목록을 제공합니다.

경로 매개변수

  • id 문자열 필수 사항

    프로젝트 ID

application/json

body 필수 사항

소스별 컨텍스트 빌드 요청

  • format_style 문자열
  • include_memories 부울
  • max_tokens integer

    MaxTokens는 총 컨텍스트 구성 예산(가져오기 비용 아님)으로, build_context와 같이 해석됩니다: 서버 500-토큰 서식 지정 예비비를 뺀 다음, 꼭 맞는 전체 메모리 청크를 탐욕스럽게 선택합니다.

    최소값은 1입니다.

  • model_type 문자열
  • 쿼리 문자열 필수 사항
  • query_embedding 배열[숫자]
  • 다시 순위를 매기다 부울

    재지정은 병합된 결과를 관련성에 따라 재정렬합니다(사용 가능한 경우 재지정).

  • session_id 문자열
  • 출처 배열[객체] 필수 사항

    소스는 명시적인 소스별로 구성된 검색 설정하다 입니다. 메모리 서버 카운트 바운드(1..MAX_CONTEXT2_SOURCES), 각 소스의 top_k 바운드 및 중복 소스 금지 규칙을 적용합니다.

    소스 속성 숨기기 소스 속성 표시 객체
    • metadata_filter 객체

      추가 속성이 허용됩니다.

    • 모드 문자열
    • source 문자열 필수 사항
    • top_k integer
  • user_id 문자열 필수 사항
  • 가시성 문자열

응답

  • 지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        유효성 검사 에 실패한 필드입니다.

        필드 속성 숨기기 필드 속성 표시 객체

        필드 및 해당 유효성 검사 실패.

        • description 문자열 필수 사항

          사람이 읽을 수 있는 유효성 검사 실패.

        • 필드 문자열 필수 사항

          잘못된 요청 필드 의 이름 또는 경로입니다.

    • 세부 정보 문자열 필수 사항

      사람이 읽을 수 있는 오류 세부 정보.

    • 오류 integer 필수 사항

      HTTP status code.

    • 오류 코드 문자열 필수 사항

      기계가 읽을 수 있는 오류 코드입니다.

    • 매개변수 array[string]

      오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.

    • 이유 문자열 필수 사항

      HTTP 상태 이유 구문입니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        유효성 검사 에 실패한 필드입니다.

        필드 속성 숨기기 필드 속성 표시 객체

        필드 및 해당 유효성 검사 실패.

        • description 문자열 필수 사항

          사람이 읽을 수 있는 유효성 검사 실패.

        • 필드 문자열 필수 사항

          잘못된 요청 필드 의 이름 또는 경로입니다.

    • 세부 정보 문자열 필수 사항

      사람이 읽을 수 있는 오류 세부 정보.

    • 오류 integer 필수 사항

      HTTP status code.

    • 오류 코드 문자열 필수 사항

      기계가 읽을 수 있는 오류 코드입니다.

    • 매개변수 array[string]

      오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.

    • 이유 문자열 필수 사항

      HTTP 상태 이유 구문입니다.

  • 200

    소스별 메타데이터 포함된 어셈블된 컨텍스트 페이로드

  • 400

    요청 본문이 잘못되었거나 user_id/ 쿼리/sources가 누락되었습니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 401

    자격 증명 누락되었거나 유효하지 않습니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 403

    호출자에게 프로젝트 에 대한 읽기 액세스 없습니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 500

    내부 오류

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
  • 502

    메모리 서비스에 연결할 수 없습니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
    응답 속성 숨기기 응답 속성 표시 객체
    • 코드 문자열
    • 오류 문자열
    • Success 부울
POST /api/v1/projects/{id}/memory/reterieval/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
}