Léim go dtí an príomhábhar
Gaeilge— Roghnaigh teanga
Roghchlár

Téamú agus saincheapadh

Ceacht 18 as 25 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Aon oibiacht roghanna amháin
  2. An téama
  3. An scáileán tosaigh
  4. An cumadóir
  5. Ceannleabhar, stair, agus freagairtí
  6. Teanga
  7. Ag cur gach rud le chéile
  8. Príomhphointí

An ceacht athscríofa an 3 Samhain, 2026. Bhraitheann an leagan roimhe seo ar chomhpháirteanna agus roghanna nach bhfuil i ChatKit: ChatProvider, MessageInput, léiriú teachtaireachta saincheaptha, agus bileoga stíle insteallta. Leanann sé anois treoir Theming and customization OpenAI agus na cineálacha ó @openai/chatkit 1.9.0; rinneadh an sampla iomlán a fhíorú trí thiomsú TypeScript. Tá difríocht idir dhá ainm sa treoir agus sa phacáiste foilsithe, agus leanann an ceacht seo an pacáiste: label (seachas name) do mholtaí na scáileine tosaigh, agus leftAction agus rightAction (seachas customButtonLeft agus customButtonRight) do chnaipí an chinn. Foincí: Theming and customization in ChatKit · ChatKitOptions reference · ChatKit Studio.

Aon oibiacht roghanna amháin

Tarlaíonn gach saincheapadh ChatKit trí oibiacht roghanna aonair. I React, cuirtear chuig useChatKit({...}) í; leis an gcomhpháirt ghréasáin, chuig chatkit.setOptions({...}). Tá an chruth céanna ag an dá chás, mar sin baineann gach rud a fhoghlaimíonn tú anseo le gach comhtháthú.

Tagann toradh amháin as an ailtireacht a clúdaíodh sa cheacht roimhe: déanann ChatKit léiriú laistigh de iframe, mar sin ní féidir le do bhileog stíle teacht air. Ní bhaineann do rialacha CSS ach leis an gcoimeádán—an méid agus an suíomh a thugann tú do <ChatKit className="…" />. Cumraítear gach rud eile trí roghanna. Is dea-scéal é seo don chothabháil: ní féidir le nuashonrú ChatKit briseadh a dhéanamh ar roghnóirí CSS nach bhfuil ann.

Chun roghanna a thriail gan cód a scríobh, taispeánann seomra spraoi ChatKit Studio léiriú beo.

An téama

Rialaíonn an téama an chuma ghinearálta: scéim dathanna, dath béime, ga cúinne, dlús, agus clóghrafaíocht.

const { control } = useChatKit({
  api: { url: '/chatkit', domainKey: 'local-dev' },
  theme: {
    colorScheme: 'dark',
    color: {
      accent: { primary: '#2D8CFF', level: 2 },
    },
    radius: 'round',
    density: 'compact',
    typography: { fontFamily: "'Inter', sans-serif", baseSize: 16 },
  },
});

Tá tacar dúnta luachanna ag gach socruithe, rud a fhíoraíonn TypeScript duit:

RoghaLuachannaÉifeacht
colorScheme'light', 'dark'Téama geal (réamhshocraithe) nó dorcha
color.accentprimary (heics, rgb(), hsl()…), level ó 0 go 3Dath béime an chomhéadain agus déine an phailéid
color.grayscalehue i gcéimeanna, tint ó 0 go 9, shade ó −4 go 4Lí agus scáth an phailéid liath
color.surfacebackground, foregroundDathanna dromchla: cúlra agus tulra (téacs, deilbhíní)
radius'pill', 'round', 'soft', 'sharp'Ga cúinne do bholgóidí, cnaipí, agus réimsí
density'compact', 'normal', 'spacious'Spásáil ghinearálta
typographyfontFamily, fontFamilyMono, baseSize (14 go 18), fontSourcesClófhoirne agus bunmhéid; lódálann fontSources clófhoireann ghréasáin (family, src, weight…)

Chun leanúint le rogha an úsáideora, roghnaigh an scéim agus tú ag tógáil na roghanna, mar shampla le window.matchMedia('(prefers-color-scheme: dark)').matches. Glactar freisin le theme laghdaithe go teaghrán, theme: 'dark', nuair nach bhfuil agat ach an scéim dathanna a shocrú.

An scáileán tosaigh

Is féidir le snáithe folamh a bheith scanrúil. Cuireann an scáileán tosaigh in ionad é é le beannacht agus moltaí a thaispeánann don úsáideoir cad is féidir leis an gcúntóir a dhéanamh:

startScreen: {
  greeting: 'Hello! How can I help you?',
  prompts: [
    { label: 'Track an order', prompt: 'Where is my latest order?', icon: 'search' },
    { label: 'Open a ticket', prompt: 'I would like to report an issue.', icon: 'write' },
  ],
},

Is é label téacs an chnaipí, is é prompt an teachtaireacht a sheoltar nuair a chliceálann an t-úsáideoir, agus is ainm ó liosta deilbhíní ChatKit é icon (search, write, calendar, lightbulb…), nó deilbhín Lucide san fhoirm 'lucide:name'.

An cumadóir

Cumraíonn an oibiacht composer an téacs ionadaíoch, na huirlisí a thairgtear don úsáideoir, agus na ceangaltáin:

composer: {
  placeholder: 'Ask a question about your order…',
  tools: [
    { id: 'order-search', label: 'Search order', icon: 'search', pinned: true },
  ],
  attachments: {
    enabled: true,
    maxCount: 3,
    maxSize: 20 * 1024 * 1024, // 20 MB per file
    accept: { 'application/pdf': ['.pdf'], 'image/*': ['.png', '.jpg'] },
  },
},

Seoltar an uirlis a roghnaítear ón roghchlár chuig an freastalaí mar rogha uirlise don chéad bhabhta eile; caithfidh tú cuntas a thabhairt air i do ghníomhaire.

Tá ceangaltáin díchumasaithe de réir réamhshocraithe, agus éilíonn a gcumasú obair ar thaobh an fhreastalaí. Le do fhreastalaí féin, caithfidh tú a shonrú freisin in api conas a uaslódáiltear comhaid: uploadStrategy: { type: 'direct', uploadUrl: '…' } (cuireann an comhéadan an comhad chuig do chríochphointe) nó { type: 'two_phase' } (iarrann sé URL sínithe, ansin uaslódálann sé an comhad chuig do stóras). Ar thaobh Python, soláthraíonn tú AttachmentStore ansin. Ná seiceáil enabled: true go dtí go bhfuil an píblíne seo ann.

Ceannleabhar, stair, agus freagairtí

header: {
  title: { text: 'Order Assistant' },
  leftAction: { icon: 'settings-cog', onClick: () => openSettings() },
},
history: { enabled: true, showRename: true, showDelete: false },
threadItemActions: { feedback: true, retry: true },
disclaimer: { text: "Responses may contain errors. [Our terms](/terms)" },
  • Taispeánann header teideal seasta (seachas teideal an tsnáithe reatha) agus suas le dhá chnap saincheaptha, leftAction agus rightAction, gach ceann acu le deilbhín cinn (settings-cog, home…) agus feidhm. Folaíonn header: { enabled: false } an ceannleabhar ar fad nuair a sholáthraíonn d’iarratas a bharra féin cheana féin.
  • Cumasaíonn history painéal na gcomhráite a chuaigh thart, le hathainmniú agus scriosadh nó gan iad. Díchumasaigh é nuair nach bhfuil ciall le coincheap an tsnáithe do do chás úsáide, mar shampla do chúntóir tacaíochta gan cuntais úsáideora.
  • Taispeánann threadItemActions.feedback cnaipí ordag suas agus síos faoi fhreagairtí. Tagann gach cliceáil chuig do fhreastalaí sa mhodh add_feedback de do ChatKitServer (thread_id, item_ids, feedback socraithe go 'positive' nó 'negative'). Is é seo an t-amhábhar do do mheastóireachtaí. Cuireann retry an cnaipe leis a athghineann freagra.
  • Taispeánann disclaimer téacs gairid Markdown faoin gcumadóir.

Teanga

De réir réamhshocraithe, úsáideann ChatKit teanga an bhrabhsálaí. Má tá socruithe teanga dá chuid féin ag d’iarratas, forghníomhaigh é le locale: 'en', nó leagan réigiúnach cosúil le 'en-US' nó 'en-GB'. Iompraíonn gach iarratas a sheoltar chuig do fhreastalaí an teanga seo sa cheanntásc Accept-Language: bain úsáid as chun an gníomhaire a fhreagairt agus chun do theachtaireachtaí uirlise a aistriú sa teanga chéanna leis an gcomhéadan.

Ag cur gach rud le chéile

Seo cumraíocht iomlán, tiomsaithe mar atá le @openai/chatkit-react 1.6.1:

import { ChatKit, useChatKit } from '@openai/chatkit-react';

export function OrderAssistant({ openSettings }: { openSettings: () => void }) {
  const dark = window.matchMedia('(prefers-color-scheme: dark)').matches;

  const { control } = useChatKit({
    api: { url: '/chatkit', domainKey: 'local-dev' },
    locale: 'en',
    theme: {
      colorScheme: dark ? 'dark' : 'light',
      color: { accent: { primary: '#2D8CFF', level: 2 } },
      radius: 'round',
      density: 'normal',
    },
    startScreen: {
      greeting: 'Hello! How can I help you?',
      prompts: [
        { label: 'Track an order', prompt: 'Where is my latest order?', icon: 'search' },
        { label: 'Open a ticket', prompt: 'I would like to report an issue.', icon: 'write' },
      ],
    },
    composer: { placeholder: 'Ask a question about your order…' },
    header: {
      title: { text: 'Order Assistant' },
      leftAction: { icon: 'settings-cog', onClick: openSettings },
    },
    history: { enabled: true, showRename: true, showDelete: false },
    threadItemActions: { feedback: true, retry: true },
  });

  return <ChatKit control={control} className="h-[640px] w-full max-w-md" />;
}

Príomhphointí

  • Tarlaíonn gach saincheapadh trí oibiacht roghanna aonair, atá comhionann i React (useChatKit) agus leis an gcomhpháirt ghréasáin (setOptions)
  • Déanann ChatKit léiriú in iframe: ní stíleálann do CSS ach an coimeádán; téann gach rud eile trí theme
  • theme: colorScheme, color.accent, radius, density, typography, le luachanna dúnta arna bhfíorú ag TypeScript
  • Cuireann startScreen (beannacht agus moltaí), composer (ionadaí, uirlisí, ceangaltáin), header, history, threadItemActions, disclaimer, agus locale an comhéadan i gcrích
  • Éilíonn ceangaltáin agus aiseolas úsáideora tacaíocht ar thaobh an fhreastalaí: uploadStrategy agus AttachmentStore, chomh maith leis an modh add_feedback