Girdeji:
- Agenti 'model + gurallar + aýlaw' hökmünde kesgitlemek we haçan gerekdigini kesgitlemek
- Gural kesgitlemesini at, düşündiriş we giriş_shema bilen ýazmak
- Tool_use we tool_result aýlawynyň akymyna we ýalňyş işleýşine gözegçilik etmek
Şu wagta çenli model hemişe bir işi ýerine ýetirdi: tekst girizmek, tekst jogaplaryny bermek. Emma hakyky iş köplenç tekstden has köp zady talap edýär; hasaplamany ýerine ýetirmek, maglumat bazasyny gözlemek, API çagyrmak, häzirki walýuta hümmetini tapmak. Model bu zatlary özi edip bilmeýär - ýöne haçan edilmelidigini çözüp biler we kimdir birini etmegini haýyş edip biler. Bu gurallary ulanmagyň modeli berýär we AI agentleriniň esasyny düzýär. Bu bölümde agentiň nämedigini, guralyň nähili kesgitlenýändigini we tool_use aýlawynyň nähili işleýändigini öwreneris.
Agent näme? Model + Gurallar + Aýlaw
AI agenti üç bölekden durýar: model (karar berýän beýni), gurallar (modeliň çagyryp biljek funksiýalary: howa, maglumat bazasy soragy, e-poçta ibermek) we aýlaw (aýlaw; model gural diýýär, netijäni alýar, näme etmelidigini ýene karar berýär we ş.m.).
Möhüm tapawut: patternekeje nagyş jaňy agent däl. Agent, modeliň ädimme-ädim dowam edýän prosesi, her ädimde guralyň netijesine esaslanyp indiki hereketi saýlaýar. "Adam ýaly pikir ediň, elleriňizi ulanyň, netijä serediň, gaýtadan pikirleniň."
Möhüm hakykat: Modeliň özi ulagy dolandyrmaýar. Model diňe "Bu gurallar bilen bu gural diýmek isleýärin" diýýär. Programmaňyz (jylaw diýilýär) guraly işledýär we netijäni modele gaýtaryp berýär. Howpsuzlyk üçin bu möhümdir: model ulgamyňyza göni degmeýär; Her bir hereket siziň gözegçiligiňizde.
Maslahat: Agent bilen her meseläni çözmäge synanyşmaň. Agent; gijikdirmek, çykdajylar we ýalňyşlyklar töwekgelçiligini ýokarlandyrýar. Ilki bilen soraň: "Bu ýekeje jaň ýa-da kesgitlenen iş prosesi bilen çözülermi?" Jogap hawa bolsa, agente zerurlyk ýok. Agent, ädimleri öňünden bilip bolmaýan açyk meseleler üçin.
Gural kesgitlemesi: ady, düşündirişi, giriş_shemasy
Bir gural modele girizmek üçin üç zady berýärsiňiz:
- ady: Ulagyň şahsyýeti, meselem get_weather.
- düşündiriş: Gural näme edýär we haçan jaň etmeli. Bu, modeliň öz wagtynda gerekli guraly saýlamagyna mümkinçilik berýän iň möhüm ugur. Diňe "näme edýär" däl, "haçan jaň et" ýazyň.
- input_schema (giriş shemasy): Guralyň haýsy parametrlere garaşýandygyny, haýsy görnüşinde JSON shemasy.
# Ulag kesgitlemesi (konseptual - JSON shema) {"name": "get_order_status", "description": "Sargytyň häzirki iberiş ýagdaýyny alýar. Ulanyjy sargyt belgisiniň nirededigini ýa-da haçan geljekdigini soranda jaň ediň.", "Input_schema": {"type": "object", "häsiýet": {"order": "zerur": ["order_no"]}}
Gowy gural düşündirişiniň düzgünleri: düşnükli we gysga at, "haçan ulanmaly" bilen düşündiriş, her parametr üçin düşündiriş, hakykatdanam hökmany bolanlary goýmak. Ulaglaryň sanyny üns merkezinde saklaň; Şuňa meňzeş ulag modelleriniň onlarçasy geň galdyryjy.
meýdany
Näme edýär?
gowy mysal
erbet mysal
ady
Ulag belgisi
sargyt_status_getir
getir
beýany
Haçan jaň etmeli
"Goük ýagdaýyny görkezýär; ulanyjy buýrugyň nirededigini soranda jaň ediň."
"maglumatlary alýar"
input_schema
Parametriň görnüşi we zerurlygy
{order_no: setir, düşündirişli}
diagramma / düşündiriş ýok
tool_use → tool_result aýlawy
Sikl ädimme-ädim şeýle işleýär:
- Ulanyja sorag + gurallaryň beýanyny modele iberýärsiňiz.
- Model ýa göni jogap berýär ýa-da gural_use blok döredýär: "order_no = SP-1024 bilen order_durumu_getir jaň ediň."
- Programmaňyz aslynda guraly işledýär (maglumat bazasyny soraýar).
- Netijäni gural_result hökmünde modele yzyna iberýärsiňiz.
- Bu netije bilen model iň soňky jogaby çykarýar ýa-da başga bir gural çagyrýar. Sikl, model "Men gutardym" diýýänçä dowam edýär.
# Agent aýlawy (konseptual) habarlar = [ulanyjy_ sorag] Hakyky: jogap = model.uret (habarlar, gurallar = gural_definitions) eger response.tur == "tool_use": result = harness.run (response.tool_name, response.entries) # APPLICATION habarlary işledýär + = [jogap, gural_result (netije) # gutarnykly netije; aýlaw gutarýar
Häzirki zaman SDK-lary bu aýlawy işleýän gural ylgaýjylaryny hödürleýär; diňe gural funksiýalaryny ýazýarsyňyz. That'söne perdäniň aňyrsynda bolup geçýän zat.
Roralňyşlyklary dolandyrmak
Gurallar şowsuz bolup biler: sargyt tapylmady, API wagty gutardy, giriş nädogry. Guraly işledip bilmeýän bolsaňyz, ýalňyşlygy beýan ediji gural_result ("ýalňyşlyk: SP-9999 sargyt belgisi tapylmady") we säwlik baýdagy hökmünde modele gaýtaryň. Model muny görüp, ulanyja ýuwaşlyk bilen düşündirip biler ýa-da başgaça synap biler. Erroralňyşlygy ýuwutmaň we boş netijeleri gaýtaryň; Model nämäniň nädogrydygyny bilmelidir.
Gowşak / güýçli ulag beýany
Gowşak (näbelli at, "haçan" ýok):
ady: "maglumatlar", düşündiriş: "maglumatlary alýar" # Model haçan we nädip jaň etjegini bilenok; Asla jaň etmeýär ýa-da nädogry jaň edýär.
Güýçli (net ady + haçan + parametr düşündirişi):
ady: "musteri_bakiyesi_getir" düşündiriş: "Müşderiniň häzirki hasap balansyny yzyna gaýtaryp berýär. Ulanyjy debet, karz ýa-da balans sorasa jaň ediň. Töleg tölemeýär." input_schema: {custeri_id: string ("Müşderi ID")} # Model öz wagtynda, dogry çäkleri bilip jaň edýär.
Üç kiçi waka
1-nji waka - Gereksiz agent. Bir topar köp gurally agent bilen “jemleýji tekst” işini gurdy; Her gezek 4 model jaň we 9 sekunt gerek. Bu iş aslynda bir gezeklik işdi. Agenti aýyranymyzda we ýekeje jaňda gysgaldanymyzda wagt 1,5 sekunt azaldy we bahasy dörtden birine çenli azaldy. Sapak: hakykatdanam zerur bolanda agenti ulanyň.
2-nji waka - Gowşak düşündiriş, nädogry jaň. Goldaw agentinde, balans soragynda-da, iberiş soragynda-da model tarapyndan tötänleýin çagyryldy. Ulaglar balans_getir we cargo_durumu_getir we “haçan jaň ediň” düşündirişleri goşulanda, nädogry mysallar 50 mysalda 18-den 1-e çenli azaldy.
3-nji waka - roralňyşlyk ýuwudyldy. Buýruk tapylmansoň, agent boş netijeleri gaýtaryp berýärdi; Model muny "sargyt gowşuryldy" diýip düşündirdi we müşderini azdyrdy. Erroralňyşlyk habary tool_result ("buýruk tapylmady") aç-açan ýazylanda, model "Bu nomeri tapyp bilmedim, barlap bilersiňizmi?" diýip başlady.
Adaty ýalňyşlyklar
- Hemme zady agente öwürmek: Bir jaň ýeterlik bolsa-da, agent çykdajy we gijikdirýär.
- Ulagyň düşnüksiz beýany: Model haçan jaň etjegini bilenok; ýalňyş saýlaýar.
- Modeliň ulagy dolandyrýandygyny pikir etmek: Dwigatel ulagy dolandyrýar; model diňe isleýär.
- Erroralňyşlygy ýuwutmak: Model nämäniň nädogrydygyny bilmelidir; Erroralňyşlygy açyk gural_result hökmünde beriň.
- Şuňa meňzeş ulaglar gaty köp: Model bulaşýar; Gurallar toplumyny ünsli we minimal derejede saklaň.
Üns beriň: Modeliň "şol ulaga jaň ediň" diýmegi, çäre görülmegini aňlatmaýar. Weýran ediji gurallarda (öçürmek, çykmak, e-poçta ibermek) programmaňyz jaňy kör ýerine ýetirmeli däldir - bu indiki bölümdäki howpsuzlyk mowzugynyň özenidir.
Gysgaça
- Agent = model (karar) + gurallar (funksiýalar) + aýlaw (jaň guraly, netije alyň, gaýtadan karar beriň).
- Patternekeje nagyş jaňy agent däl; agent ädim ädimdir.
- Model ulagy dolandyrmaýar; Programmaňyz işleýär (enjam) we netijäni tool_result görnüşinde yzyna berýär.
- Gural ady, düşündirişi (esasanam "haçan jaň et") we giriş_shemasy bilen kesgitlenýär.
- Aýlaw gural_use → harp işleýär → tool_result → model "ýerine ýetirildi" diýilýänçä dowam edýär; ýalňyşlyklar modele aç-açan habar berilýär.
Programma meselesi
Agente berip boljak öz işiňizden 3 gural düzüň. (1) Adyny, "haçan jaň et" bilen düşündirişini we hersi üçin giriş_shemany ýazyň; Iň bolmanda biri weýran ediji okama guraly we biri hasaplama bolsun. (2) Hakyky ulanyjy soragyny saýlaň we bu gurallaryň haýsysynyň haýsy giriş bilen jaň etjekdigini we tool_result gelenden soň näme etjekdigini ädimme-ädim (aýlawda) el bilen ýazyň. (3) Gurallaryň biriniň şowsuz bolan ssenariýasyny düzüň we säwlik habarynyň modele nädip gaýdyp geljekdigini görkeziň.
gözegçilik sanawy
- [] Agenti "model + gurallar + aýlaw" diýip kesgitläp bilerin we haçan gerekdigini kesgitläp bilerin.
- [] Jübütiň ulagy dolandyrýandygyny bilýärin, model diňe isleýär.
- [] Ady, düşündirişi ("haçan jaň et") we input_schema bilen gaty ulagyň beýany ýazyp bilerin.
- Men [] tool_use → tool_result siklini ädimme-ädim yzarlap bilerin.
- [] Açyk gural_result hökmünde modele gural ýalňyşlyklaryny habar berýärin.