베타 RAG 수집 파이프라인 설정 엔드포인트

베타 RAG 수집 파이프라인 설정 엔드포인트 (Beta Rag Ingestion Pipeline Configurations Endpoints)

(beta) RAG API - ingestion pipeline configurations입니다. 문서 수집(ingestion) 파이프라인 설정을 등록·조회하고 실행 정보를 갱신하는 엔드포인트예요.

출처: 문서

본문

RAG를 위해 문서를 중간 처리(청킹 등)해서 인덱스로 넣는 수집 파이프라인의 설정을 관리하는 API예요. 어떤 설정들이 등록되어 있는지 보고, 새로 등록하고, 마지막 실행 결과(청크 수, 실행 시각)를 갱신할 수 있답니다.

GET /v1/rag/ingestion_pipeline_configurations — List ingestion pipeline configurations (수집 파이프라인 설정 목록)

현재 워크스페이스에서 등록된 모든 수집 파이프라인 설정을 나열합니다.

응답 (200): 타입 array<IngestionPipelineConfiguration>.

  • IngestionPipelineConfiguration — {object}

TypeScript:

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: proces...EY"] ?? "",
});

async function run() {
  const result = await mistral.beta.rag.ingestionPipelineConfigurations.list();

  console.log(result);
}

run();

Python:

from mistralai.client import Mistral
import os

with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.rag.ingestion_pipeline_configurations.list()

    # Handle response
    print(res)

curl:

curl https://api.mistral.ai/v1/rag/ingestion_pipeline_configurations \
 -X GET \
 -H 'Authorization: Bearer ***'

응답 예시 (200):

[
  {
    "author_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
    "created_at": "2025-12-17T10:25:07.818693Z",
    "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
    "last_run_chunks_count": 87,
    "last_run_time": null,
    "modified_at": "2025-12-17T10:41:03.469341Z",
    "name": "My resource",
    "pipeline_composition": null,
    "total_chunks_count": 14
  }
]

PUT /v1/rag/ingestion_pipeline_configurations — Register Config (설정 등록)

수집 파이프라인 설정을 등록합니다.

요청 본문:

  • name#string (필수) — 설정 이름.
  • pipeline_composition#map<string>|null — 파이프라인 구성 맵.
  • target_indexes#array<IngestionPipelineTargetIndexRef>|null — 대상 인덱스 참조 목록.

응답 필드 (200 Successful Response):

  • id#string (필수), name#string (필수), author_id#string (필수), created_at#date-time, modified_at#date-time, last_run_chunks_count#integer (필수), last_run_time#date-time|null (필수), pipeline_composition#map<string>|null (필수), total_chunks_count#integer (필수)

TypeScript:

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: proces...EY"] ?? "",
});

async function run() {
  const result = await mistral.beta.rag.ingestionPipelineConfigurations.register({
    name: "<value>",
  });

  console.log(result);
}

run();

Python:

from mistralai.client import Mistral
import os

with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.rag.ingestion_pipeline_configurations.register(name="<value>")

    # Handle response
    print(res)

curl:

curl https://api.mistral.ai/v1/rag/ingestion_pipeline_configurations \
 -X PUT \
 -H 'Authorization: Bearer ***' \
 -H 'Content-Type: application/json' \
 -d '{
  "name": "My resource"
}'

응답 예시 (200):

{
  "author_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "created_at": "2025-12-17T10:25:07.818693Z",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "last_run_chunks_count": 87,
  "last_run_time": null,
  "modified_at": "2025-12-17T10:41:03.469341Z",
  "name": "My resource",
  "pipeline_composition": null,
  "total_chunks_count": 14
}

PUT /v1/rag/ingestion_pipeline_configurations/{id}/run_info — Update Run Info (실행 정보 갱신)

파이프라인 설정의 실행 정보를 갱신합니다.

경로 파라미터:

  • id#string (필수)

요청 본문:

  • chunks_count#integer (필수) — 마지막 실행에서 처리된 청크 수.
  • execution_time#date-time (필수) — 실행 시각.

응답 필드 (200 Successful Response): 등록 응답과 동일한 설정 필드 목록.

TypeScript:

import { Mistral } from "@mistralai/mistralai";

const mistral = new Mistral({
  apiKey: proces...EY"] ?? "",
});

async function run() {
  const result = await mistral.beta.rag.ingestionPipelineConfigurations.updateRunInfo({
    id: "6b630c1b-b57e-4237-a015-ff6247cbbcf8",
    updateRunInfo: {
      executionTime: new Date("2024-06-27T06:29:04.390Z"),
      chunksCount: 983906,
    },
  });

  console.log(result);
}

run();

Python:

from mistralai.client import Mistral
from mistralai.client.utils import parse_datetime
import os

with Mistral(
    api_key=os.getenv("MISTRAL_API_KEY", ""),
) as mistral:

    res = mistral.beta.rag.ingestion_pipeline_configurations.update_run_info(id="6b630c1b-b57e-4237-a015-ff6247cbbcf8", execution_time=parse_datetime("2024-06-27T06:29:04.390Z"), chunks_count=983906)

    # Handle response
    print(res)

curl:

curl https://api.mistral.ai/v1/rag/ingestion_pipeline_configurations/{id}/run_info \
 -X PUT \
 -H 'Authorization: Bearer ***' \
 -H 'Content-Type: application/json' \
 -d '{
  "chunks_count": 87,
  "execution_time": "2025-01-15T09:30:00Z"
}'

응답 예시 (200):

{
  "author_id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "created_at": "2025-12-17T10:25:07.818693Z",
  "id": "019b2bd7-96e7-7219-8c0b-45a73da50088",
  "last_run_chunks_count": 87,
  "last_run_time": null,
  "modified_at": "2025-12-17T10:41:03.469341Z",
  "name": "My resource",
  "pipeline_composition": null,
  "total_chunks_count": 14
}

더 알아보기 (Learn more)