Téamú agus saincheapadh
Ar an leathanach seo
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/chatkit1.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(seachasname) do mholtaí na scáileine tosaigh, agusleftActionagusrightAction(seachascustomButtonLeftaguscustomButtonRight) do chnaipí an chinn. Foincí: Theming and customization in ChatKit ·ChatKitOptionsreference · 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:
| Rogha | Luachanna | Éifeacht |
|---|---|---|
colorScheme | 'light', 'dark' | Téama geal (réamhshocraithe) nó dorcha |
color.accent | primary (heics, rgb(), hsl()…), level ó 0 go 3 | Dath béime an chomhéadain agus déine an phailéid |
color.grayscale | hue i gcéimeanna, tint ó 0 go 9, shade ó −4 go 4 | Lí agus scáth an phailéid liath |
color.surface | background, foreground | Dathanna 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 |
typography | fontFamily, fontFamilyMono, baseSize (14 go 18), fontSources | Cló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
headerteideal seasta (seachas teideal an tsnáithe reatha) agus suas le dhá chnap saincheaptha,leftActionagusrightAction, gach ceann acu le deilbhín cinn (settings-cog,home…) agus feidhm. Folaíonnheader: { enabled: false }an ceannleabhar ar fad nuair a sholáthraíonn d’iarratas a bharra féin cheana féin. - Cumasaíonn
historypainé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.feedbackcnaipí ordag suas agus síos faoi fhreagairtí. Tagann gach cliceáil chuig do fhreastalaí sa mhodhadd_feedbackde doChatKitServer(thread_id,item_ids,feedbacksocraithe go'positive'nó'negative'). Is é seo an t-amhábhar do do mheastóireachtaí. Cuireannretryan cnaipe leis a athghineann freagra. - Taispeánann
disclaimerté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, aguslocalean comhéadan i gcrích - Éilíonn ceangaltáin agus aiseolas úsáideora tacaíocht ar thaobh an fhreastalaí:
uploadStrategyagusAttachmentStore, chomh maith leis an modhadd_feedback