Neidio i'r prif gynnwys
SDK Sgwrsfot Next.js

Ychwanegwch sgwrsfot AI personol at integreiddiad Next.js

Defnyddiwch @openstaticfish/chattybox o fewn ffin cleient benodol tra bo gweddill eich cymhwysiad App Router yn aros wedi'i rendro ar y gweinydd. Mae ChattyBox yn ymdrin ag adalw, dyfyniadau, sgyrsiau a graddio.

Yn cropian tudalennau dogfennaeth cyhoeddedigAtebion sy'n dyfynnu ffynonellauAdeiladwch ryngwyneb pwrpasol gyda'r SDKNid oes angen mudo dogfennauNid oes angen cerdyn credydMae eich cynnwys yn parhau'n eiddo i chi
Gofynnwch i ChattyBox
Ble ddylwn i ddechrau os oes angen ateb dibynadwy arnaf o'r wefan hon?
Dechreuwch drwy ychwanegu URL eich gwefan gyhoeddus at ChattyBox. Mae’n adalw cynnwys wedi’i fynegeio i arwain atebion a gall ddangos dolenni i dudalennau ffynhonnell i ymwelwyr eu harchwilio. Profwch atebion ac ymatebion wrth gefn cyn lansio.
iFfynonellau3^
Platfform Next.js canllaw
chattybox.ai
Dadansoddeg
chattybox.ai
Cartref
chattybox.ai

Sgwrs enghreifftiol — nid sgwrs fyw.

Wedi'i bweru gan ChattyBox

Lansiwch chatbot â dyfyniadau ffynhonnell heb ailadeiladu pentwr eich gwefan

Mae ChattyBox yn cropian eich gwefan bresennol, dogfennaeth, canolfan gymorth, CMS neu sylfaen wybodaeth. Gall cynnwys a adferwyd arwain atebion y chatbot; gwiriwch atebion a dyfyniadau am gywirdeb.

Cadwch yr arwyneb sgwrsio rhyngweithiol mewn ffin use client fach.
Datgelwch allwedd teclyn gyhoeddus wedi'i chyfyngu i darddleoedd yn unig drwy newidynnau NEXT_PUBLIC.
Cyflwynwch atebion â dyfyniadau gyda'ch system ddylunio Next.js a chragen cymhwysiad bresennol.
Gadewch i ChattyBox reoli cropian, adalw, storio fectorau, cynhyrchu atebion a graddio.
Cam llif gwaith

Gosodwch @openstaticfish/chattybox yn y cymhwysiad Next.js.

Cam llif gwaith

Ychwanegwch allwedd API gyhoeddus y teclyn ac URL yr API fel newidynnau amgylchedd NEXT_PUBLIC.

Cam llif gwaith

Crëwch gydran cleient ar gyfer cyflwr y sgwrs a rhyngweithio'r porwr.

Cam llif gwaith

Mewnforiwch y gydran cleient honno o dudalen neu gynllun Cydran Gweinydd.

Lansiad tri cham

Cysylltwch eich gwefan gyhoeddus neu'ch dogfennaeth, profwch atebion â chyfeiriadau at ffynonellau, yna adeiladwch eich rhyngwyneb gyda'r SDK.

Adeiladwch sgwrsfot Next.js
Integreiddio App Router

Ychwanegwch ryngweithio heb ildio rendro ar y gweinydd

Cadwch yr SDK ar ymyl y cleient lle mae'r sgwrs yn digwydd a chadwch Gydrannau Gweinydd ar gyfer gweddill y cymhwysiad.

Llwybr penderfyniad

Defnyddiwch y pwyntiau gwirio hyn i benderfynu a ddylai ChattyBox eistedd wrth ymyl eich platfform docs, amnewid cynorthwyydd ar wahân, neu aros yn ynysig ar gyfer profi.

01

Ffin cleient fach

Marciwch y modiwl sgwrsio rhyngweithiol yn unig gyda use client yn lle symud tudalen neu gynllun cyfan i'r porwr.

02

Eglurder allwedd gyhoeddus

Defnyddiwch allwedd prosiect sy'n ddiogel i'r porwr gyda tharddleoedd a ganiateir; peidiwch byth â datgelu manylion rheoli drwy newidynnau NEXT_PUBLIC.

03

Rhyngwyneb cynnyrch personol

Cyflwynwch negeseuon a dyfyniadau yn eich llywio, ardal cyfrif, cragen ddogfennau neu lif gwaith cymorth eich hun.

04

Dim gwasanaeth RAG personol

Peidiwch ag ychwanegu route handlers dim ond i ddirprwyo API porwr a reolir oni bai bod gan eich cynnyrch angen penodol ar ochr y gweinydd.

Llwybr gosod

Crëwch gleient sgwrsio Next.js App Router

Mae'r SDK yn defnyddio fetch a manylion prosiect sy'n weladwy i'r porwr, felly cychwynnwch ef mewn modiwl cleient. Peidiwch â rhoi cyfrinachau nac APIs rheoli mewn newidynnau NEXT_PUBLIC.

  1. 1Gosodwch y pecyn npm a ffurfweddwch allwedd gyhoeddus wedi'i chyfyngu i darddleoedd.
  2. 2Crëwch gydran use client sy'n rheoli cyflwr negeseuon a sgyrsiau.
  3. 3Cyflwynwch y gydran o'ch tudalen wedi'i rendro ar y gweinydd heb droi'r llwybr cyfan yn gydran cleient.
Adeiladwch sgwrsfot Next.js
app/components/chat.tsx
tsx
'use client';

import { useState, type FormEvent } from 'react';
import { Chattybox, ChattyboxError, type ChatResponse } 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 [question, setQuestion] = useState('');
  const [answer, setAnswer] = useState<ChatResponse | null>(null);
  const [pending, setPending] = useState(false);
  const [error, setError] = useState('');

  async function ask(event: FormEvent<HTMLFormElement>) {
    event.preventDefault();
    const message = question.trim();
    if (pending || !message || message.length > 2000) return;
    setPending(true);
    setError('');
    try {
      const result = await chattybox.sendMessage({
        message,
        // Same ID includes up to 12 recent saved messages, not the full transcript.
        conversationId: answer?.conversationId,
      });
      // The backend may return a provider failure in an otherwise successful response.
      if ('providerError' in result && typeof result.providerError === 'string' && result.providerError) {
        setError('Chat could not be completed.');
        return;
      }
      setAnswer(result);
      setQuestion('');
    } catch (failure) {
      setError(failure instanceof ChattyboxError
        ? failure.status + ': ' + failure.message
        : 'Chat could not be completed.');
    } finally {
      setPending(false);
    }
  }

  const sources = answer?.sources.filter((source) => {
    try { return ['https:', 'http:'].includes(new URL(source).protocol); }
    catch { return false; }
  }) ?? [];

  return (
    <section aria-label="Chat">
      <form onSubmit={ask}>
        <label>Question
          <input value={question} maxLength={2000} disabled={pending}
            onChange={(event) => setQuestion(event.target.value)} />
        </label>
        <button type="submit" disabled={pending || !question.trim()}>
          {pending ? 'Sending...' : 'Send'}
        </button>
      </form>
      {error && <p role="alert">{error}</p>}
      <div aria-live="polite" aria-busy={pending}>
        <p style={{ whiteSpace: 'pre-wrap' }}>{answer?.message}</p>
        {sources.length > 0 && <ul aria-label="Sources">
          {sources.map((source, index) => <li key={index}>
            <a href={source} target="_blank" rel="noopener noreferrer">{source}</a>
          </li>)}
        </ul>}
      </div>
    </section>
  );
}

// Import and render <Chat /> from your page or layout. This shows the latest answer, not a saved transcript.
// No automatic retries: see the SDK retry-safety guide before adding retries.
Cwestiynau cyffredin

Cwestiynau cyffredin

1

A yw SDK ChattyBox yn gweithio gydag App Router Next.js?

Ydy. Defnyddiwch ef mewn cydran cleient ar gyfer cyflwr sgwrsio rhyngweithiol a chyflwynwch y gydran honno o dudalen neu gynllun App Router.

2

A oes angen route handler Next.js arnaf ar gyfer ChattyBox?

Nac oes ar gyfer yr integreiddiad porwr arferol. Mae allweddi teclyn cyhoeddus wedi'u cynllunio ar gyfer defnydd cleient a gellir eu cyfyngu i darddleoedd cymeradwy.

3

A yw allweddi ChattyBox NEXT_PUBLIC yn gyfrinachau?

Mae allwedd gyhoeddus y teclyn yn adnabod prosiect ond nid yw'n fanylyn rheoli. Cyfyngwch hi i'ch tarddleoedd cynhyrchu a rhagolwg, a pheidiwch byth â datgelu cyfrinachau gweinyddol.

4

A allaf ddefnyddio teclyn lletyol ChattyBox gyda Next.js?

Gallwch. Mae'r canllaw gosod lletyol yn dangos y llwybr next/script pan fyddwch yn dewis rhyngwyneb a gynhelir yn lle rhyngwyneb SDK personol.

Dechreuwch am ddim

Nid oes angen cerdyn credyd

Creu chatbot am ddim

Haen am ddim. Dim angen cerdyn.