Vai al contenuto
Integra / Prosopo Developers

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.

Node.js
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.

TypeScript
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.

MetodoEffetto
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.

TypeScript
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();