JavaScript SDK: AI 참조
AI 서비스 및 세션의 모든 방법과 서명이 포함되어 있습니다.
6분 읽기·레벨 참조·2026. 10. 12.에 개정됨
이 영어 텍스트는 프랑스어 원본에서 자동으로 생성되었으며 아직 검토되지 않았습니다.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
#
수업
아이서비스
| 방법 | 설명 |
|---|---|
session(): Promise<AiSession> | 임시 티켓 AI 세션(POST /v1/ai/{project_id}/session)을 발행하고 chat/chatStream/embed에 대해 미리 만들어진 AiSession을 반환합니다. |
chat(messages: ChatMessage[], options?: { model?: string; temperature?: number; max_tokens?: number; system?: string; provider?: string; }): Promise<AuraResponse<ChatResponse>> | 채팅 완료 요청을 보냅니다. |
chatStream(messages: ChatMessage[], options?: { model?: string; temperature?: number; max_tokens?: number; signal?: AbortSignal; }): AsyncGenerator<ChatStreamChunk> | 스트리밍 채팅 완료(SSE). |
embed(req: EmbedRequest): Promise<AuraResponse<EmbedResponse>> | 주어진 입력에 대한 임베딩을 생성합니다. |
rag(req: RagRequest): Promise<AuraResponse<RagResponse>> | 검색-증강 생성: 컬렉션을 쿼리하고 답변을 얻습니다. |
ragIngest(req: RagIngestRequest): Promise<AuraResponse<RagIngestResponse>> | RAG 네임스페이스에 문서를 수집합니다. |
listNamespaces(): Promise<AuraResponse<RagNamespace[]>> | 프로젝트의 RAG 네임스페이스를 나열합니다. |
deleteNamespace(namespace: string): Promise<AuraResponse<RagDeleteResponse>> | RAG 네임스페이스(및 해당 코퍼스)를 삭제합니다. |
reindexNamespace(namespace: string): Promise<AuraResponse<RagReindexResponse>> | 현재 임베딩 모델을 사용하여 RAG 네임스페이스를 다시 인덱싱합니다(모델/차원 변경 후 수정). |
semanticSearch(query: string, namespace: string, options?: { top_k?: number; threshold?: number; }): Promise<AuraResponse<SemanticSearchResult[]>> | 임베딩 네임스페이스에 대한 의미 검색. |
nl2sql(question: string, options?: { dialect?: 'postgresql' | 'postgres'; examples?: Array<{ question: string; sql: string; }>; limit?: number; }): Promise<AuraResponse<Nl2SqlResult>> | 질문을 SQL로 변환합니다. |
#
수업
Ai세션
임시 티켓 AI 세션: 단기 기능(POST /v1/ai/{project_id}/session, 클래식 apikey 인증)을 만든 다음 이를 chat/chatStream/embed(Authorization: Bearer <ticket> 단독 — 절대 apikey)에 사용합니다.
| 재산 | 설명 |
|---|---|
get budgetRemaining(): number | 마지막 호출 시(또는 아직 호출이 이루어지지 않은 경우 민트 시) 알려진 남은 토큰 예산입니다. |
| 방법 | 설명 |
|---|---|
static create(client: AuraClientLike): Promise<AiSession> | 새로운 AI 세션을 생성합니다. |
chat(messages: ChatMessage[], options?: AiSessionChatOptions): Promise<AiSessionChatResult> | 이 세션에서는 채팅이 스트리밍되지 않습니다. |
chatStream(messages: ChatMessage[], options?: AiSessionChatStreamOptions): AsyncGenerator<ChatStreamChunk> | 이 세션의 스트리밍 채팅(SSE)입니다. |
embed(input: string): Promise<AiSessionEmbedResult> | 이 세션에 삽입 중입니다({input} → {embedding, budget_remaining}). |
생성된 페이지
이 페이지는 SDK의 유형 선언 및 주석에서 생성되므로 게시된 코드에서 표류할 수 없습니다. 실제 사례를 보려면 가이드를 읽어보세요.
마지막 업데이트 · 2026. 10. 12.