API DocsGlobal SettingsModels

모델

AI 모델 설정 및 관리

개요

모델 설정을 통해 시스템에서 사용 가능한 AI 모델을 설정하고 동작을 커스터마이즈할 수 있습니다. 모델은 다양한 기본 프로바이더를 사용할 수 있으며, 연결에서 커스텀 툴을 포함할 수 있습니다.

기본 URL:

태스크 파이프라인

이 설정은 모델의 글로벌 프롬프트를 업데이트합니다. 제목 생성, 태그 생성, 후속 질문, 쿼리 생성과 같은 백그라운드 작업을 위한 태스크 파이프라인을 설정합니다.

GET /api/v1/tasks/config

태스크 파이프라인 설정(제목 생성, 후속 질문 생성, 태그, 함수 호출, 쿼리 생성 프롬프트)을 반환합니다.

GETAdmin only

태스크 파이프라인 설정을 가져옵니다 (관리자 전용).

응답 200

json
{
"TASK_MODEL": "",
"TASK_MODEL_EXTERNAL": "",
"ENABLE_TITLE_GENERATION": true,
"TITLE_GENERATION_PROMPT_TEMPLATE": "...",
"ENABLE_TAGS_GENERATION": true,
"TAGS_GENERATION_PROMPT_TEMPLATE": "...",
"ENABLE_FOLLOW_UP_GENERATION": true,
"FOLLOW_UP_GENERATION_PROMPT_TEMPLATE": "...",
"ENABLE_AUTOCOMPLETE_GENERATION": false,
"AUTOCOMPLETE_GENERATION_INPUT_MAX_LENGTH": -1,
"ENABLE_SEARCH_QUERY_GENERATION": true,
"ENABLE_RETRIEVAL_QUERY_GENERATION": true,
"QUERY_GENERATION_PROMPT_TEMPLATE": "...",
"TOOLS_FUNCTION_CALLING_PROMPT_TEMPLATE": "..."
}

POST /api/v1/tasks/config/update

태스크 파이프라인 설정을 업데이트합니다. 전체 설정 객체를 전송하세요 (GET 응답 형식에서 업데이트된 값으로).

POSTAdmin only

태스크 파이프라인 설정을 업데이트합니다 (관리자 전용).

요청 본문

업데이트된 값으로 전체 설정 객체를 전송하세요.

json
{
"TASK_MODEL": "",
"TASK_MODEL_EXTERNAL": "",
"ENABLE_TITLE_GENERATION": true,
"TITLE_GENERATION_PROMPT_TEMPLATE": "...",
"ENABLE_TAGS_GENERATION": true,
"TAGS_GENERATION_PROMPT_TEMPLATE": "...",
"ENABLE_FOLLOW_UP_GENERATION": true,
"FOLLOW_UP_GENERATION_PROMPT_TEMPLATE": "...",
"ENABLE_AUTOCOMPLETE_GENERATION": false,
"AUTOCOMPLETE_GENERATION_INPUT_MAX_LENGTH": -1,
"ENABLE_SEARCH_QUERY_GENERATION": true,
"ENABLE_RETRIEVAL_QUERY_GENERATION": true,
"QUERY_GENERATION_PROMPT_TEMPLATE": "...",
"TOOLS_FUNCTION_CALLING_PROMPT_TEMPLATE": "..."
}

응답 200

업데이트된 태스크 설정 객체.

태스크 파이프라인 설정 필드

필드타입설명
TASK_MODELstring백그라운드 태스크에 사용할 모델 (채팅 모델 재정의)
TASK_MODEL_EXTERNALstring외부 태스크 모델 ID
ENABLE_TITLE_GENERATIONboolean첫 번째 응답 후 제목 자동 생성
TITLE_GENERATION_PROMPT_TEMPLATEstring제목 생성을 위한 프롬프트 템플릿
ENABLE_TAGS_GENERATIONboolean채팅 내용에서 태그 자동 생성
TAGS_GENERATION_PROMPT_TEMPLATEstring프롬프트 템플릿; { "tags": [...] } 형식으로 출력해야 함
ENABLE_FOLLOW_UP_GENERATIONboolean후속 질문 자동 생성
FOLLOW_UP_GENERATION_PROMPT_TEMPLATEstring프롬프트 템플릿; { "follow_ups": [...] } 형식으로 출력해야 함
ENABLE_AUTOCOMPLETE_GENERATIONboolean메시지 자동완성 활성화
AUTOCOMPLETE_GENERATION_INPUT_MAX_LENGTHinteger자동완성 최대 입력 길이 (-1 = 무제한)
ENABLE_SEARCH_QUERY_GENERATIONboolean웹 검색 쿼리 생성 활성화
ENABLE_RETRIEVAL_QUERY_GENERATIONbooleanRAG 검색 쿼리 생성 활성화
QUERY_GENERATION_PROMPT_TEMPLATEstring검색/탐색 쿼리 생성을 위한 프롬프트 템플릿
TOOLS_FUNCTION_CALLING_PROMPT_TEMPLATEstring툴/함수 호출을 위한 글로벌 기본 프롬프트