Limite del cliente piccolo
Contrassegna solo il modulo di chat interattiva con use client invece di spostare un'intera pagina o layout nel browser.
Utilizza @openstaticfish/chattybox all'interno di un limite client mirato mentre il resto della tua applicazione App Router rimane sottoposto a rendering del server. ChattyBox gestisce il recupero, le citazioni, le conversazioni e il ridimensionamento.
ChattyBox esegue la scansione della documentazione esistente, indicizza il contenuto per il recupero e incorpora un chatbot che risponde utilizzando i tuoi documenti anziché la memoria del modello generico.
Installa @openstaticfish/chattybox nell'applicazione Next.js.
Aggiungi la chiave API del widget pubblico e API URL come variabili di ambiente NEXT_PUBLIC.
Crea un componente client per lo stato della chat e l'interazione con il browser.
Importa il componente client da una pagina o un layout del componente server.
Lancio in tre fasi
Mantieni SDK sul lato client dove avviene l'interazione della chat e preserva i componenti server per il resto dell'applicazione.
Contrassegna solo il modulo di chat interattiva con use client invece di spostare un'intera pagina o layout nel browser.
Utilizzare una chiave di progetto sicura per il browser con origini consentite; non esporre mai le credenziali di gestione tramite le variabili NEXT_PUBLIC.
Visualizza messaggi e citazioni nella tua navigazione, nell'area dell'account, nella shell dei documenti o nel flusso di lavoro di supporto.
Evita di aggiungere gestori di route esclusivamente per eseguire il proxy di un browser gestito API a meno che il tuo prodotto non abbia un requisito concreto lato server.
SDK utilizza fetch e le credenziali del progetto visibili dal browser, quindi inizializzalo in un modulo client. Mantieni i segreti e la gestione API fuori dalle variabili NEXT_PUBLIC.
'use client';
import { useState } from 'react';
import { Chattybox } from '@openstaticfish/chattybox';
const chattybox = new Chattybox({
apiKey: process.env.NEXT_PUBLIC_CHATTYBOX_API_KEY!,
baseUrl: process.env.NEXT_PUBLIC_CHATTYBOX_API_URL!,
});
export function Chat() {
const [answer, setAnswer] = useState('');
async function ask(message: string) {
const response = await chattybox.sendMessage({ message });
setAnswer(response.message);
}
return <div aria-live="polite">{answer}</div>;
}Esaminare il pacchetto sottostante e i limiti dell'infrastruttura gestita.
Visualizza i modelli di componenti e stati condivisi dalle applicazioni React.
Esamina i campi di risposta, le conversazioni di follow-up e gli errori.
Utilizza next/script e il widget gestito UI per un'esperienza di chat senza compilazione.
SÌ. Usalo in un componente client per lo stato della chat interattiva ed esegui il rendering di quel componente da una pagina o un layout App Router.
Non per la normale integrazione del browser. Le chiavi widget pubbliche sono progettate per l'uso da parte dei client e possono essere limitate alle origini approvate.
La chiave widget pubblica identifica un progetto ma non è una credenziale di gestione. Limitalo alla tua produzione e alle origini in anteprima e non esporre mai segreti amministrativi.
SÌ. La guida all'installazione ospitata mostra il percorso successivo/script quando preferisci un'interfaccia UI mantenuta anziché un'interfaccia SDK personalizzata.
Nessuna carta di credito richiesta. I tuoi contenuti non vengono usati per addestrare modelli.
Piano Free. Nessuna carta.