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

ChatKit: Forbhreathnú agus Suiteáil

Ceacht 17 as 25 Nuashonraithe 3 Samhain 2026 Forbróir
Ar an leathanach seo
  1. Cén fáth ChatKit
  2. Bealach amháin chun é a chumhachtú
  3. An ailtireacht trí phíosa
  4. Suiteáil
  5. An freastalaí íosta
  6. An comhéadan React
  7. Gan React
  8. Slándáil ón gcéad lá
  9. Má tá sreabhad oibre Agent Builder agat cheana
  10. Príomhphointí

An ceacht athscríofa an 3 Samhain, 2026. Ní raibh san leagan roimhe seo ach cur síos ar API nach bhfuil ann a thuilleadh: oibiacht new ChatKit({ apiKey, agentId }), comhpháirteanna ChatProvider, ChatWindow, agus MessageInput, modúl @openai/chatkit/react, agus script cdn.openai.com/chatkit/…. Leanann an ceacht seo treoracha oifigiúla ChatKit OpenAI anois, SDK Python openai-chatkit 1.6.5, agus @openai/chatkit-react 1.6.1. Rith muid an freastalaí samplach go logánta chun gach céim a fhíorú. Nóta: Dúnfar Agent Builder ar an 30 Samhain, 2026; fanfaidh ChatKit ar fáil. Foinse: ChatKit · Comhtháthuithe casta le ChatKit · Tosaigh go tapa leis an SDK Python · Aip tosaigh oifigiúil.

Cén fáth ChatKit

Tá gníomhaire tógtha agat leis an Agents SDK. Rithíonn sé i do theirminéal, agus ní féidir le duine ar bith eile é a úsáid. Chun é a chur i lámha do chuid úsáideoirí, teastaíonn comhéadan comhrá uait — agus tá sé costasach comhéadan comhrá maith a thógáil ón mbun. Caithfidh tú scrollú, teachtaireachtaí sruthaithe, athshlánú comhráite, ceangaltáin, taispeáint glaonna uirlisí, agus láimhseáil earráidí líonra a dhéanamh.

Is é ChatKit freagra OpenAI: comhpháirt comhrá a chuireann tú isteach i do tháirge a láimhseálann an t-eispéireas úsáideora ar fad. Cuireann an doiciméadacht béim ar a ghiuirléidí idirghníomhacha, moltaí tosaigh, taispeáint glaonna uirlisí, ceangaltáin, agus léirshamhlú réasúnaíochta an ghníomhaire. Coinníonn tú smacht ar na rudaí a tábhachtaí: an gníomhaire, do chuid sonraí, agus do chuid rialacha.

Bealach amháin chun é a chumhachtú

Níl i ChatKit ach comhéadan. Teastaíonn freastalaí uaidh a fhaigheann teachtaireachtaí, a ritheann an gníomhaire, agus a sruthaíonn an freagra ar ais. Cuireann OpenAI dhá chur chuige in iúl:

ConairConas a oibríonn séCé dó atá sé?
Do fhreastalaí ChatKit féin (comhtháthú casta)Do fhreastalaí Python, ag baint úsáide as an SDK openai-chatkit, a fhaigheann iarratais ón gcomhéadan agus a ritheann an gníomhaire is mian leat, mar shampla gníomhaire Agents SDKAon tionscadal nua: seo an conair a mholann OpenAI
Sreabhad oibre Agent Builder óstáilteRitheann OpenAI sreabhad oibre a dearadh in Agent Builder; ní chruthaíonn do fhreastalaí ach seisiúinComhtháthuithe atá ann cheana le linn na tréimhse aistrithe: dúnfar Agent Builder an 30 Samhain, 2026

Leanann an cúrsa seo an chéad chonair — an t-aon cheann a bhfuil todhchaí aige. Déanaimid achoimre ar an dara ceann ag deireadh an cheachta dóibh siúd a chaithfidh comhtháthú atá ann cheana a choinneáil suas go dtí an dúnadh.

An ailtireacht trí phíosa

Tagann comhtháthú ChatKit anuas ar thrí eilimint. Seachnaíonn an difríocht a dhéanamh eatarthu formhór na mboteanna a dhéanann tosaitheoirí:

  1. ChatKit.js, an chomhpháirt féin: comhpháirt ghréasáin <openai-chatkit> a thaispeánann an comhrá in iframe. Luchtaítear é ó CDN OpenAI (https://cdn.platform.openai.com/deployments/chatkit/chatkit.js), ní ó npm: níl ach sainmhínithe cineáil sa phacáiste npm @openai/chatkit.
  2. Ceangail React, @openai/chatkit-react, a nochtann an chomhpháirt ChatKit agus an hook useChatKit. Tá siad roghnach: gan React, rialaíonn tú an chomhpháirt ghréasáin go díreach.
  3. Do fhreastalaí ChatKit, críochphointe HTTP amháin, /chatkit de ghnáth, a fhaigheann gach iarratas ón gcomhéadan. Ródalaíonn sampla ChatKitServer iad, braitheann sé ar stóras chun snáitheanna comhrá a bhuanú, agus ritheann sé do ghníomhaire.

Ní fhágann an eochair API OpenAI an freastalaí riamh: ní labhraíonn an comhéadan ach le do chríochphointe /chatkit.

Suiteáil

Ar thaobh an chomhéadain, suiteáil na ceangail React agus luchtaigh an script ChatKit i do leathanach:

npm install @openai/chatkit-react
<!-- I gceann <head> do leathanaigh -->
<script src="https://cdn.platform.openai.com/deployments/chatkit/chatkit.js"></script>

Ar thaobh an fhreastalaí, suiteáil SDK Python ChatKit (Python 3.10 nó níos déanaí), a thugann isteach an Agents SDK, chomh maith le freastalaí gréasáin:

pip install openai-chatkit fastapi uvicorn

An freastalaí íosta

Leanann an freastalaí thíos an tosaithe tapa oifigiúil. Ní theastaíonn ach modh amháin ó ChatKitServer, respond, a ghlaotar do gach teachtaireacht úsáideora. Athluchtaíonn sé na míreanna snáithe is déanaí, tiontaíonn sé iad go hionchur gníomhaire le simple_to_agent_input, ritheann sé an gníomhaire i mód sruthaithe, agus aistríonn sé an sruth sin go himeachtaí ChatKit le stream_agent_response:

# main.py
from typing import Any, AsyncIterator

from agents import Agent, Runner
from chatkit.agents import AgentContext, simple_to_agent_input, stream_agent_response
from chatkit.server import ChatKitServer, StreamingResult
from chatkit.types import ThreadMetadata, ThreadStreamEvent, UserMessageItem
from fastapi import FastAPI, Request
from fastapi.responses import Response, StreamingResponse

from memory_store import MemoryStore  # stóras cuimhne ón aip tosaigh

assistant = Agent[AgentContext[dict[str, Any]]](
    name="Product Assistant",
    instructions="You help product users. Respond in English, briefly.",
    model="gpt-6.1-sol",
)


class MyChatKitServer(ChatKitServer[dict[str, Any]]):
    async def respond(
        self,
        thread: ThreadMetadata,
        input_user_message: UserMessageItem | None,
        context: dict[str, Any],
    ) -> AsyncIterator[ThreadStreamEvent]:
        # Na 30 mír snáithe deireanacha, athbhunaithe in ord croineolaíoch
        page = await self.store.load_thread_items(
            thread.id, after=None, limit=30, order="desc", context=context
        )
        agent_input = await simple_to_agent_input(list(reversed(page.data)))
        agent_context = AgentContext(thread=thread, store=self.store, request_context=context)
        result = Runner.run_streamed(assistant, agent_input, context=agent_context)
        async for event in stream_agent_response(agent_context, result):
            yield event


app = FastAPI()
server = MyChatKitServer(MemoryStore())


@app.post("/chatkit")
async def chatkit_endpoint(request: Request) -> Response:
    result = await server.process(await request.body(), {})
    if isinstance(result, StreamingResult):
        return StreamingResponse(result, media_type="text/event-stream")
    return Response(content=result.json, media_type="application/json")

Rith é le OPENAI_API_KEY i do thimpeallacht: uvicorn main:app --port 8000.

Tuilleann an stóras dhá fhocal. Ní stórálann ChatKit aon rud leis féin: buanaítear snáitheanna, teachtaireachtaí, giuirléidí, agus glaonna uirlisí ag aicme a dhéanann oidhreacht ar chatkit.store.Store agus a chuireann thart ar dhosaen modh i bhfeidhm (load_thread, save_thread, load_thread_items, add_thread_item…). Chun tosú, athúsáid an comhad memory_store.py ón aip tosaigh oifigiúil: coinníonn sé gach rud sa chuimhne fad a ritheann an próiseas. Sa táirgeadh, cuir bunachar sonraí ina ionad. Molann an doiciméadacht oibiachtaí a stóráil mar JSON ionas nach gcuirfidh nuashonruithe SDK iallach ort imirce scéime a dhéanamh.

An comhéadan React

Ar thaobh an chomhéadain, faigheann useChatKit an chumraíocht agus filleann sé oibiacht control, a thugann tú don chomhpháirt ChatKit:

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

export function Assistant() {
  const { control } = useChatKit({
    api: {
      url: '/chatkit',
      // I bhforbairt, is leor luach sealadach; sa táirgeadh,
      // úsáid do eochair fearainn (féach thíos)
      domainKey: 'local-dev',
    },
  });

  return <ChatKit control={control} className="h-[600px] w-[360px]" />;
}

Freastal ar an gcomhéadan agus ar /chatkit ón mbunús céanna: i bhforbairt, láimhseálann seachfhreastalaí do uirlis tógála é seo (cumraíonn an aip tosaigh seachfhreastalaí Vite chun /chatkit a atreorú go port 8000). Má tá an freastalaí ar bhunús difriúil, ceadaigh go sainráite é, mar shampla le CORSMiddleware FastAPI.

Gan React

Is féidir le suíomh WordPress, feidhmchlár Rails, nó leathanach statach an cúntóir céanna a chomhtháthú: oibríonn an chomhpháirt ghréasáin go díreach a luaithe a luchtaítear an script CDN.

<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <script src="https://cdn.platform.openai.com/deployments/chatkit/chatkit.js"></script>
  </head>
  <body>
    <div id="chat-root" style="height: 600px"></div>
    <script>
      const chatkit = document.createElement('openai-chatkit');
      chatkit.setOptions({
        api: { url: '/chatkit', domainKey: 'local-dev' },
      });
      document.getElementById('chat-root').append(chatkit);
    </script>
  </body>
</html>

Tá an fhoirm chéanna ag gach rogha a fheicfidh tú sna ceachtaí seo a leanas i ngach cás: oibiacht a thugtar do useChatKit i React, nó do setOptions ar an gcomhpháirt ghréasáin.

Slándáil ón gcéad lá

Baineann trí riail, tarraingthe ó threoir táirgeachta ChatKit, leis ón gcéim phrótaitíopa:

  • Fanann an eochair API ar an bhfreastalaí. Ní mór dó bheith le feiceáil i gcód an chomhéadain ná i do stór: léigh ó athróg timpeallachta nó ó bhainisteoir rúnda é.
  • Fíoraigh gach iarratas ar /chatkit. Ní láimhseálann an SDK é seo: caithfidh d’fheidhmchlár seisiún nó comhartha an úsáideora a fhíorú, ansin a n-aithne a thabhairt do server.process sa chomhthéacs (ceacht 21). Gan é seo, is féidir le duine ar bith do ghníomhaire a rith ar do chostas.
  • Cláraigh do fhearainn. Sula dtéann tú beo, dearbhaigh gach óstainm a thaispeánfaidh ChatKit ar leathanach Liosta ceadaithe fearainn ardán OpenAI, agus cóipeáil an eochair ghinte isteach i domainKey. Ag am luchtaithe, fíoraíonn iframe ChatKit an eochair seo le OpenAI agus diúltaíonn sé taispeáint mura bhfuil sé ann nó mura n-oireann sé.

Má tá sreabhad oibre Agent Builder agat cheana

Oibríonn comhtháthuithe atá ann cheana atá nasctha le sreabhad oibre óstáilte go dtí go ndúntar Agent Builder. Tá a bprionsabal difriúil: cruthaíonn do fhreastalaí seisiún ChatKit trí POST https://api.openai.com/v1/chatkit/sessions a ghlaow, leis an gceanntásc OpenAI-Beta: chatkit_beta=v1, an t-aithneoir sreabha oibre, agus aitheantóir user atá uathúil do gach úsáideoir fíoraithe. Ansin filleann sé an client_secret a fuarthas ar an gcomhéadan. Ar thaobh an chomhéadain, glacann an rogha api feidhm getClientSecret ansin in ionad URL.

Ná tosaigh tionscadal nua ar an múnla seo. Maidir le comhtháthú atá ann cheana, onnmhairigh an sreabhad oibre go cód Agents SDK agus athraigh go do fhreastalaí ChatKit féin roimh an 30 Samhain, 2026, ag leanúint na treorach Aistrigh ó Agent Builder.

Príomhphointí

  • Is comhéadan comhrá réidh le comhtháthú é ChatKit; ritheann do fhreastalaí an gníomhaire
  • Do gach tionscadal nua: do fhreastalaí ChatKit féin (pip install openai-chatkit), le modh respond agus críochphointe /chatkit; dúnfar Agent Builder óstáilte an 30 Samhain, 2026
  • Luchtaítear an comhéadan ó CDN OpenAI; i React, úsáid useChatKit agus <ChatKit control={control} /> ó @openai/chatkit-react
  • Buaníonn an stóras snáitheanna comhrá: sa chuimhne le haghaidh tástála, i mbunachar sonraí don táirgeadh
  • Eochair API ar an taobh freastalaí amháin, /chatkit fíoraithe, fearainn cláraithe chun an domainKey a fháil