Kleine Client-Grenze
Markieren Sie nur das interaktive Chatmodul mit use client, statt eine ganze Seite oder ein Layout in den Browser zu verlagern.
Nutzen Sie @openstaticfish/chattybox in einer gezielten Client-Grenze, während der Rest Ihrer App-Router-Anwendung serverseitig gerendert bleibt. ChattyBox übernimmt Suche, Quellenangaben, Konversationen und Skalierung.
ChattyBox crawlt Ihre bestehende Dokumentation, indexiert die Inhalte für den Abruf und bettet einen Chatbot ein, der mit Ihren Docs antwortet statt mit generischem Modellgedächtnis.
Installieren Sie @openstaticfish/chattybox in der Next.js-Anwendung.
Fügen Sie den öffentlichen Widget-API-Schlüssel und die API-URL als NEXT_PUBLIC-Umgebungsvariablen hinzu.
Erstellen Sie eine Client-Komponente für Chatstatus und Browser-Interaktion.
Importieren Sie diese Client-Komponente aus einer Server-Component-Seite oder einem Layout.
Dreistufiger Start
Halten Sie das SDK an der Client-Grenze der Chatinteraktion und bewahren Sie Server Components für den Rest der Anwendung.
Markieren Sie nur das interaktive Chatmodul mit use client, statt eine ganze Seite oder ein Layout in den Browser zu verlagern.
Nutzen Sie einen browsersicheren Projektschlüssel mit erlaubten Ursprüngen; legen Sie Verwaltungszugänge nie über NEXT_PUBLIC-Variablen offen.
Zeigen Sie Nachrichten und Quellenangaben in Navigation, Kontobereich, Dokumentationshülle oder Supportworkflow an.
Fügen Sie keine Route Handler nur als Proxy für eine verwaltete Browser-API hinzu, sofern kein konkreter serverseitiger Bedarf besteht.
Das SDK verwendet fetch und im Browser sichtbare Projektzugänge. Initialisieren Sie es daher in einem Client-Modul. Secrets und Verwaltungs-APIs gehören nicht in NEXT_PUBLIC-Variablen.
'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>;
}Informieren Sie sich über das zugrunde liegende Paket und die Grenze der verwalteten Infrastruktur.
Sehen Sie Komponenten- und Statusmuster, die React-Anwendungen gemeinsam haben.
Informieren Sie sich über Antwortfelder, Folgegespräche und Fehler.
Nutzen Sie next/script und die gepflegte Widget-Oberfläche für ein Chat-Erlebnis ohne Build-Schritt.
Ja. Nutzen Sie es in einer Client-Komponente für interaktiven Chatstatus und rendern Sie diese aus einer App-Router-Seite oder einem Layout.
Nicht für die normale Browser-Integration. Öffentliche Widget-Schlüssel sind für die Client-Nutzung gedacht und lassen sich auf erlaubte Ursprünge beschränken.
Der öffentliche Widget-Schlüssel identifiziert ein Projekt, ist aber kein Verwaltungszugang. Beschränken Sie ihn auf Produktions- und Vorschau-Ursprünge und legen Sie nie administrative Secrets offen.
Ja. Die gehostete Installationsanleitung zeigt den Weg mit next/script, wenn Sie eine gepflegte Oberfläche statt einer eigenen SDK-Oberfläche bevorzugen.
Keine Kreditkarte erforderlich. Ihre Inhalte werden nicht für Modelltraining verwendet.
Kostenloser Tarif. Keine Karte nötig.