SDK JavaScript: riferimento AI
Ogni modalità del servizio AI e delle sessioni, con la relativa firma.
6 min letto·Livello riferimento·Revisionato il 12 ott 2026
Questo testo inglese è stato generato automaticamente dall'originale francese e non è stato ancora rivisto.
Questa pagina è stata tradotta automaticamente. Fa fede la versione inglese.
#
Classe
AiService
| Metodo | Descrizione |
|---|---|
session(): Promise<AiSession> | Conia una sessione AI di ticket effimero (POST /v1/ai/{project_id}/session) e restituisce un AiSession già pronto per chat/chatStream/embed. |
chat(messages: ChatMessage[], options?: { model?: string; temperature?: number; max_tokens?: number; system?: string; provider?: string; }): Promise<AuraResponse<ChatResponse>> | Invia una richiesta di completamento della chat. |
chatStream(messages: ChatMessage[], options?: { model?: string; temperature?: number; max_tokens?: number; signal?: AbortSignal; }): AsyncGenerator<ChatStreamChunk> | Completamento della chat in streaming (SSE). |
embed(req: EmbedRequest): Promise<AuraResponse<EmbedResponse>> | Genera incorporamenti per gli input specificati. |
rag(req: RagRequest): Promise<AuraResponse<RagResponse>> | Retrieval-Augmented Generation: interroga una raccolta e ottieni una risposta. |
ragIngest(req: RagIngestRequest): Promise<AuraResponse<RagIngestResponse>> | Inserisci un documento in uno spazio dei nomi RAG. |
listNamespaces(): Promise<AuraResponse<RagNamespace[]>> | Elenca gli spazi dei nomi RAG del progetto. |
deleteNamespace(namespace: string): Promise<AuraResponse<RagDeleteResponse>> | Elimina uno spazio dei nomi RAG (e il relativo corpus). |
reindexNamespace(namespace: string): Promise<AuraResponse<RagReindexResponse>> | Reindicizza uno spazio dei nomi RAG con il modello di incorporamento corrente (riparazione dopo una modifica del modello/dimensione). |
semanticSearch(query: string, namespace: string, options?: { top_k?: number; threshold?: number; }): Promise<AuraResponse<SemanticSearchResult[]>> | Ricerca semantica su uno spazio dei nomi incorporato. |
nl2sql(question: string, options?: { dialect?: 'postgresql' | 'postgres'; examples?: Array<{ question: string; sql: string; }>; limit?: number; }): Promise<AuraResponse<Nl2SqlResult>> | Traduce una domanda in SQL. |
#
Classe
AiSession
Sessione AI ticket effimera: conia una funzionalità di breve durata (POST /v1/ai/{project_id}/session, classica apikey auth) quindi usala per chat/chatStream/embed (Authorization: Bearer <ticket> ALONE — mai apikey).
| Proprietà | Descrizione |
|---|---|
get budgetRemaining(): number | Budget gettone rimanente, noto all'ultima chiamata (o pari al nuovo se non è stata ancora effettuata alcuna chiamata). |
| Metodo | Descrizione |
|---|---|
static create(client: AuraClientLike): Promise<AiSession> | Conia una nuova sessione AI. |
chat(messages: ChatMessage[], options?: AiSessionChatOptions): Promise<AiSessionChatResult> | Chat non trasmessa in streaming in questa sessione. |
chatStream(messages: ChatMessage[], options?: AiSessionChatStreamOptions): AsyncGenerator<ChatStreamChunk> | Chat in streaming (SSE) in questa sessione. |
embed(input: string): Promise<AiSessionEmbedResult> | Incorporamento in questa sessione ({input} → {embedding, budget_remaining}). |
Pagina generata
Questa pagina viene generata dalle dichiarazioni di tipo e dai commenti dell'SDK, quindi non può derivare dal codice pubblicato. Per esempi pratici, leggi le guide.
Ultimo aggiornamento · 12 ott 2026