JavaScript SDK
Costruisci la tua interfaccia e collega il renderer a una conversazione. Token temporanei nel browser, credenziali nel tuo server.
Disponibilità del pacchetto
@prosopo/sdk e @prosopo/sdk-server sono pacchetti del workspace di questo repository. Non sono ancora distribuiti su npm: per integrarli in un altro progetto occorre prepararne la distribuzione. Gli esempi qui sotto funzionano nel workspace.
1. Crea un token sul server
La chiave vtk_ deve rimanere sul tuo backend. Restituisci al browser il token e la persona pubblica inclusi nella risposta. Autentica il tuo endpoint applicativo prima di generare token.
import { createSessionToken } from "@prosopo/sdk-server";
const session = await createSessionToken({
baseUrl: process.env.PROSOPO_BASE_URL,
apiKey: process.env.PROSOPO_API_KEY,
personaId: PERSONA_ID,
origin: "https://app.example",
});
// Restituisci session al tuo frontend autenticato.2. Monta e connetti
Importa lo stylesheet del pacchetto. Il contenitore deve avere un’altezza esplicita. connect() attende l’evento ready; al termine della pagina chiama destroy() per liberare microfono, audio e renderer. Per riconnetterti usa un nuovo token.
import { createProsopo } from "@prosopo/sdk";
import "@prosopo/sdk/style.css";
const session = await fetch("/your-session-endpoint", { method: "POST" })
.then(r => { if (!r.ok) throw new Error("Sessione rifiutata"); return r.json(); });
const client = createProsopo({
baseUrl: "https://prosopo.example",
token: session.session_token,
mediaToken: session.media_token,
persona: session.persona,
});
await client.mount(document.getElementById("avatar")!, { ui: "glass" });
client.on("transcript", text => console.log(text));
client.on("error", message => console.error(message));
await client.connect();
client.sendText("Ciao!");
// A fine conversazione: await client.destroy();Controlli e input
sendText invia una domanda al modello. talk legge il testo direttamente con la voce della persona, utile se il modello lo gestisci tu. sendAudio accetta PCM s16le mono a 24 kHz, massimo 96000 byte per messaggio; imposta microphone: false per disattivare la cattura automatica.
| Metodo | Effetto |
|---|---|
| connect() | Promise risolta quando il server è pronto |
| sendText(text) | Risposta tramite LLM |
| talk(text) | Voce diretta, senza LLM; massimo 1500 caratteri |
| sendAudio(buffer) | Ingresso audio per trascrizione e risposta |
| setMuted(boolean) | Attiva/disattiva ingresso microfono |
| interrupt() | Interrompe la risposta corrente |
| disconnect() / destroy() | Disconnette / libera tutte le risorse |
Eventi
on restituisce una funzione per annullare l’iscrizione. Gli eventi transcript sono il testo completo accumulato della risposta; event espone i messaggi grezzi del protocollo, inclusi audio, fonemi, usage e generation_done.
const unsubscribe = client.on("state", state => console.log(state));
client.on("session", ({ session_id }) => console.log(session_id));
client.on("userTranscript", text => console.log(text));
client.on("action", action => console.log(action));
client.on("event", event => console.log(event.type));
// unsubscribe();