Gnóthachain:
- Gníomhaire a shainiú mar 'mhúnla + uirlisí + lúb' agus cinneadh a dhéanamh nuair is gá é
- Ag scríobh sainmhíniú na huirlise le hainm, cur síos agus ionchur_schema
- Monatóireacht a dhéanamh ar shreabhadh agus láimhseáil earráide an lúb tool_use agus tool_result
Go dtí seo, tá jab amháin déanta ag an tsamhail i gcónaí: faigh ionchur téacs, déan freagraí téacs. Ach is minic a éilíonn fíor-obair níos mó ná téacs; ríomh a dhéanamh, bunachar sonraí a cheistiú, API a ghlaoch, ráta malairte reatha a fháil amach. Ní féidir leis an tsamhail na rudaí seo a dhéanamh í féin - ach is féidir léi cinneadh a dhéanamh nuair is gá iad a dhéanamh agus iarraidh ar dhuine éigin iad a dhéanamh. Is é seo an méid a thugann úsáid uirlisí don mhúnla, agus is é seo bunús gníomhairí AI. San aonad seo, foghlaimfimid cad is gníomhaire ann, conas a shainítear an uirlis, agus conas a oibríonn an lúb tool_use.
Cad is Gníomhaire ann? Samhail + Uirlisí + Lúb
Tá trí chuid i ngníomhaire AI: an tsamhail (an inchinn a dhéanann an cinneadh), na huirlisí (na feidhmeanna is féidir leis an múnla a ghlaoch: aimsir, ceist bhunachar sonraí, ríomhphost a sheoladh), agus an lúb (an lúb; glaonn an tsamhail an uirlis, faigheann an toradh, cinneann arís cad atá le déanamh, agus mar sin de).
Idirdhealú criticiúil: Ní gníomhaire é glao patrún aonair. Is próiseas é Gníomhaire ina dtéann an tsamhail ar aghaidh céim ar chéim, ag gach céim ag roghnú an chéad ghluaiseacht eile bunaithe ar thoradh na huirlise. "Smaoinigh cosúil le duine, bain úsáid as do lámha, féach ar an toradh, smaoineamh arís."
Fíric thábhachtach: Ní oibríonn an tsamhail féin an fheithicil. Deir an tsamhail go díreach "Ba mhaith liom an uirlis seo a ghlaoch leis na hionchuir seo". Ritheann d’iarratas (ar a dtugtar úim) an uirlis agus cuireann sé an toradh ar ais chuig an tsamhail. Tá sé seo ríthábhachtach don tslándáil: ní dhéanann an tsamhail teagmháil dhíreach le do chóras; Tá gach gníomh faoi do smacht.
Leid: Ná déan iarracht gach fadhb a réiteach leis an ngníomhaire. Gníomhaire; méadaítear an baol moilleanna, costais agus earráidí. Fiafraigh ar dtús: “An réiteofar é seo le glao amháin nó le sreabhadh oibre seasta?” Más é an freagra tá, níl aon ghá le gníomhaire. Tá an gníomhaire le haghaidh tascanna neamhiata nuair nach féidir na céimeanna a bheith ar eolas roimh ré.
Sainmhíniú Uirlis: ainm, cur síos, ionchur_schema
Chun uirlis a thabhairt isteach sa mhúnla, tugann tú trí rud:
- ainm: Céannacht na feithicle, e.g. faigh_aimsir.
- cur síos: Cad a dhéanann an uirlis agus cathain a ghlaoch air. Is é seo an réimse is tábhachtaí a ligeann don mhúnla an uirlis cheart a roghnú ag an am ceart. Scríobh ní hamháin "cad a dhéanann" ach freisin "glao nuair."
- ionchur_schema (scéimre ionchuir): scéimre JSON a shainíonn na paraiméadair a bhfuil súil ag an uirlis, cén cineál.
# Sainmhíniú feithicle (coincheapúil — scéimre JSON) { " name " : " get_order_status " , " description " : " Aisghabhann an stádas seolta ordaithe faoi láthair. Glaoigh nuair a fhiafraíonn an t-úsáideoir cá bhfuil uimhir ordaithe nó cathain a shroichfidh sé.", "input_schema": { "type": "object", " property ": { " order_noscription ": { " order_noscription ": { " order_noscription ": { " order_noscription " : " { " order_noscription " : " { " order_noscription " : " { " order_noscription " : " { " order_noscription " : " { " order_noscription " : " { " order_noscription " : " { " order_noscription " : " { " order_de " : " { " order_de " : " { " order_de " : " { " order_noscription " : " # Sainmhíniú feithicle (coincheapúil — scéimre JSON) uimhir, m.sh. SP-1024" } }, "riachtanach": [ "ordú_níl" ] }}
Rialacha maidir le cur síos ar uirlis mhaith: ainm soiléir agus gonta, cur síos le "cén uair ba cheart a úsáid", cur síos ar gach paraiméadar, ag cur na cinn fíor-éigeantacha i bhfeidhm. Coinnigh líon na bhfeithiclí dírithe; Is ionadh é na dosaenacha de mhúnlaí feithicle den chineál céanna.
cheantar
Cad a dhéanann sé?
dea-shampla
drochshampla
ainm
Aitheantas feithicle
ordú_stádas_getir
thabhairt
tuairisc
Cad a dhéanann sé + nuair a ghlaoch
msgstr "Tugann an stádas lasta ar ais; glaoigh nuair a fhiafraíonn an t-úsáideoir cá bhfuil an t-ordú"
"fetches data"
ionchur_scéim
Cineál paraiméadar agus riachtanas
{ord_no: teaghrán, anótáilte}
gan léaráid / gan tuairisc
tool_use → tool_result Lúb
Oibríonn an timthriall mar seo, céim ar chéim:
- Cuireann tú an cheist úsáideora + tuairiscí uirlisí chuig an tsamhail.
- Freagraíonn an tsamhail go díreach nó gineann sé bloc tool_use: "glao order_drumu_getir le order_no=SP-1024."
- Is é d'iarratas a ritheann an uirlis (ceistíonn an bunachar sonraí).
- Seolann tú an toradh ar ais chuig an tsamhail mar tool_result.
- Leis an toradh seo, táirgeann an tsamhail an freagra deiridh nó glaonna uirlis eile. Leanann an timthriall go dtí go deir an tsamhail "Tá mé déanta."
# Agent loop (conceptual)messages = [user_question]while True: response = model.uret(messages, tools=tool_definitions) if response.tur == "tool_use": result = harness.run(response.tool_name, response.entries) # APPLICATION runs messages += [ return(sult, tool_re break) # toradh deiridh; foircinn lúb
Tairgeann SDKanna nua-aimseartha reathaithe uirlisí a ritheann an lúb seo duit; scríobhann tú díreach na feidhmeanna uirlis. Ach sin go díreach atá ag tarlú taobh thiar de na cásanna.
Bainistíocht Earráidí
Seans go dteipfidh ar uirlisí: níor aimsíodh an t-ordú, tá an API caite, tá an t-ionchur neamhbhailí. Mura bhfuil tú in ann an uirlis a rith, cuir an earráid ar ais chuig an tsamhail mar tool_result tuairisciúil ("earráid: níor aimsíodh uimhir an ordaithe SP-9999") agus bratach na hearráide. Is féidir leis an tsamhail é seo a fheiceáil agus é a mhíniú go réidh don úsáideoir, nó iarracht a dhéanamh ar bhealach difriúil. Ná swallow an earráid agus ar ais torthaí folamh; Ní mór go mbeadh a fhios ag an tsamhail cad a chuaigh mícheart.
Cur síos Lag/Láidre Feithicle
Lag (ainmfhocal éiginnte, ní "nuair"):
name: "data", description: "fetches data" # Níl a fhios ag an tsamhail cathain agus conas é a ghlaoch; Ní chuireann sé glaoch ar chor ar bith nó glaonna mícheart.
Láidir (glanainm + cathain + cur síos ar pharaiméadar):
name: "musteri_bakiyesi_getir" description: "Filleann sé iarmhéid cuntais reatha an chustaiméara. Glaoigh air nuair a iarrann an t-úsáideoir dochair, creidmheas nó iarmhéid. NÍ DHÉANANN íocaíocht." input_schema: {custeri_id: string ("Aitheantas an Chustaiméara")}# Glaonn an tsamhail ag an am ceart, leis na paraiméadair chearta, agus a theorainn ar eolas aige.
Trí Chás Mini
Cás 1 — Gníomhaire neamhriachtanach. Thóg foireann amháin an gnó “achoimriú téacs” le gníomhaire iluirlis; Bíonn 4 ghlao samhalta agus 9 soicind i gceist le gach achoimre. Post aon ghlao a bhí sa phost i ndáiríre. Nuair a bhaineamar an gníomhaire agus laghdaigh sé go dtí glao amháin, laghdaigh an t-am go 1.5 soicind agus laghdaigh an costas go dtí an ceathrú cuid. Ceacht: bain úsáid as an ngníomhaire nuair is gá i ndáiríre.
Cás 2 - Míniú lag, glao mícheart. I ngníomhaire tacaíochta, ghlaoigh an tsamhail uirlis doiléir ar a dtugtar fetch go randamach sa cheist iarmhéid agus sa cheist loingseoireachta. Nuair a roinneadh na feithiclí i balance_getir agus cargo_drumu_getir agus cuireadh míniúcháin "glao nuair" leis, tháinig laghdú ar roghnú mícheart feithicle ó 18 go 1 i 50 sampla.
Cás 3 - Slogtar an earráid. Bhí gníomhaire ag filleadh torthaí folamh nuair nach bhfuarthas an t-ordú; Léirigh an tsamhail é seo mar "seachadadh an t-ordú" agus chuir sé an custaiméir amú. Nuair a scríobhtar an teachtaireacht earráide go sainráite chuig tool_result ("ordú gan aimsiú"), deir an tsamhail i gceart "Ní raibh mé in ann an uimhir seo a aimsiú, an féidir leat é a sheiceáil?" thosaigh sé ag rá.
Botúin choitianta
- Ag casadh gach rud chuig gníomhaire: Cé gur leor glao amháin, cuireann an gníomhaire costas agus moill leis.
- Cur síos doiléir ar an bhfeithicil: Níl a fhios ag an múnla cathain is ceart glaoch; roghnaíonn mícheart.
- Ag smaoineamh go ritheann an tsamhail an fheithicil: Ritheann an úim an fheithicil; is mian leis an tsamhail.
- An earráid a shlogadh: Ní mór go mbeadh a fhios ag an tsamhail cad a chuaigh mícheart; Tabhair an earráid mar tool_result oscailte.
- Iomarca feithiclí comhchosúla: Bíonn mearbhall ar an tsamhail; Coinnigh an tacar uirlisí dírithe agus íosta.
Aird: Díreach mar a deir an tsamhail ní chiallaíonn "cuir glaoch ar an bhfeithicil sin" gur cheart beart a dhéanamh. Maidir le huirlisí millteach (scrios, seiceáil amach, r-phost) níor cheart go ndéanfadh d’iarratas an glao a chur i gcrích go dall – is é seo croílár an ábhair slándála sa chéad aonad eile.
Go hachomair
- Gníomhaire = múnla (cinneadh) + uirlisí (feidhmeanna) + lúb (uirlis glaoch, toradh a fháil, cinneadh a dhéanamh arís).
- Ní gníomhaire é glao patrún aonair; Is próiseas céim ar chéim é gníomhaire.
- Ní ritheann an tsamhail an fheithicil; Ritheann d’iarratas (úim) agus seolann sé an toradh ar ais mar tool_result.
- Aithnítear an uirlis de réir ainm, tuairisc (go sonrach "glaoch nuair"), agus ionchur_schema.
- Leanann an lúb mar tool_use → ritheann úmacha → tool_result → leanann an tsamhail go dtí go deir an tsamhail "déanta"; déantar earráidí a thuairisciú go sainráite don tsamhail.
Tasc feidhmchláir
Dear 3 uirlis ó do ghnó féin is féidir a thabhairt don ghníomhaire. (1) Scríobh ainm, cur síos le "glaoch nuair", agus ionchur_schema do gach; Bíodh ar a laghad ceann amháin ina uirlis léitheoireachta neamh-millteach agus ceann amháin ina ríomh. (2) Roghnaigh ceist úsáideora réalaíoch agus scríobh de láimh céim ar chéim (i lúb) cé acu de na huirlisí seo a ghlaofaidh an tsamhail lena n-ionchuir agus cad a dhéanfaidh sé tar éis don tool_result teacht. (3) Socraigh cás ina dteipeann ar cheann de na huirlisí agus taispeáin conas a rachaidh an teachtaireacht earráide ar ais chuig an tsamhail.
seicliosta
- [ ] Is féidir liom an gníomhaire a shainiú mar "múnla + uirlisí + lúb" agus cinneadh a dhéanamh nuair is gá é.
- [ ] Tá a fhios agam go ritheann an leas a bhaint as an bhfeithicil, níl ag teastáil ón múnla ach é.
- Is féidir liom cur síos ar fheithicil soladach a scríobh le [ ] ainm, cur síos ("glaoch nuair") agus ionchur_schema.
- Is féidir liom an timthriall [ ] tool_use → tool_result a leanúint céim ar chéim.
- [ ] Tuairiscím earráidí uirlisí don mhúnla mar open tool_result.