InoteveraGaidhi rinotevera
Turning OpenAPI Specs into LLM Tools
Tekinoroji
Nhungamiro yehunyanzvi
Kugadzira maturusi evashandi veLLM kunoreva kunyora mazita, tsananguro, parameter schemas, zvinobuda uye mhosho meseji inoverengwa nemhando yemutauro kuti usarudze kuti nderipi basa rekudaidza uye kuti ungaridaidza sei.
Teerera kugwaro iriAI-yakarondedzerwa · ~3 min
Iyo modhi haina kumboona kodhi yako, ichi chinyorwa chete, saka tsananguro isina kujeka kana sloppy schema inoburitsa mafoni asiri iwo akavimbika sezvinoita bug.
Tsanangudzo yechishandiso ine zvikamu zvina zvemuenzaniso zvinoenderana: zita, tsananguro yemutauro wechisikigo, schema yekuisa (kazhinji JSON Schema), uye mameseji ayo chishandiso chinotumira kumashure. Imwe neimwe inoshanda sekukurumidza. Iyo modhi inosarudza kudaidza chishandiso nekufananidza chinangwa chemushandisi kune tsananguro, uye inozadza nharo uchishandisa parameter mazita, mhando, enums uye mienzaniso. Mazita akanaka akananga uye akaiswa mumapoka. Maprefixes akadai segithub_create_issue uye jira_create_issue anochengeta maturusi akaparadzana kana mumiririri akabatana nemasevhisi mazhinji. Tsanangudzo dzakanaka dzinotaura zvinoitwa nechishandiso, nguva yekuchishandisa, nguva yekusaita, uye zvachinodzosera, mafambisirwo aungapfupikisa waunoshanda naye mutsva. Maparamita anofanirwa kutaura zvaanoreva: user_id iri nani pane id, uye enum yemhando dzinotenderwa inorova tambo yemahara-yemhando iyo modhi inofanirwa kufungidzira. Zvinobuda zvine basa semapupu. Kudzosa zviuru zvemitsara kana maID emukati manyoro anozadza hwindo remukati uye anovanza ruzivo rwakakosha. Zvirinani maturusi anodzosa minda inoverengwa, paginate kana truncate nekukasira, uye dzimwe nguva inopa yakapfupika kana yakadzama modhi. Mhosho dzemeseji dzinofanirwa kuudza modhi izvo zvakakanganisika uye zvekuyedza zvinotevera, nekuti modhi inovaverenga uye kuita pairi. Imwe pfungwa isiriyo yakajairika ndeyekuti mamwe maturusi anoreva mumiriri anokwanisa. Tsanangudzo yega yega inotora mamiriro pakutendeuka kwese, uye maturusi anopindirana anoita kuti sarudzo dziome. Kurongeka kunoita kudonha sezvo rondedzero yezvishandiso ichikura kureba, kunyanya kana maturusi achitaridzika zvakafanana. Hapana universal cutoff inoshanda. Vazhinji varapi vanotanga kuona dambudziko kune imwe nzvimbo mumakumi ezvishandiso, uye zvakajairwa zvigadziriso kubatanidza maturusi, kuaisa pazvinenge zvichidiwa, kana kupatsanura basa kune vakasiyana vamiririri. Imwe pfungwa isiriyo ndeyekuti maturusi anofanirwa kuratidzira iripo API imwe-kune-imwe. Maajenti anowanzo kuita zvirinani nematurusi mashoma, epamusoro-soro akaumbwa akatenderedza mabasa anoitwa nevanhu.
Mumiriri wetsigiro aive nematurusi maviri, search_orders uye get_order. Kuvapa zita rekuti orders_search_by_customer uye orders_get_by_id uye kutaura mune imwe neimwe tsananguro nguva yekushandisa imwe cheka nhamba yenhare dzinotumirwa kune isiriyo chishandiso.
Chishandiso chekarenda chakatora nzvimbo yemazuva emahara chakaramba chichiwana 'Chipiri chinotevera'. Kuchinja schema kuti kuda ISO 8601 date tambo ine muenzaniso mune tsananguro yakabvisa kirasi yese yekutadza kutadza.
Chishandiso chedatabase chaimbodzosera 'Kanganiso 1064' mbishi ikozvino chadzoka 'Column created_date haipo. Makoramu emazuva aripo: created_at, updated_at.' Mumiririri anogadzirisa zvawabvunza pane inotevera kuedza pane kurega.
Chikwata chakafumura 60 pedyo-yakafanana endpoint wrappers kune mumwe mumiririri. Kuzvibatanidza kuita gumi nemaviri-basa-level maturusi, senge schedule_meeting munzvimbo yeakasiyana list_users, find_free_slots uye create_event call, zvakaita kuti mumiririri akurumidze uye adhure kumhanya.
Dhizaini yezvishandiso iri kuve chirango chayo, negwaro rakaburitswa kubva kune vanopa modhi uye magungano akagovaniswa anopararira kuburikidza nemaprotocol akadai seModel Context Protocol. Mamwe mapuratifomu anogona ikozvino kutsvaga uye kurodha maturusi tsananguro pazvinodiwa, izvo zvinorerutsa kudzvanywa kwekuchengeta rondedzero pfupi, kunyangwe tsananguro dzichiri kufanira kujeka zvakakwana kuwana uye kusarudza. Mamodheru ari kushandiswawo kutsoropodza nekunyora patsva tsananguro dzematurusi zvichienderana nezvinyorwa zvekuongorora. Mutemo wekutanga haugone kuchinja: modhi inogona kungoshandisa chishandiso pamwe chete nechimiro chayo chinotsanangura, saka zita rakajeka, schemas yakasimba uye zvikanganiso zvinobatsira zvicharamba zviri pakati.
Tsamba yemahara
Nhatu dzakasimbiswa dzeAI nyaya mangwanani ega ega pakati pevhiki, dzakanyorwa neChirungu chakajeka. Yemahara zvachose, hapana ads.
Imwe email zuva rega rega revhiki. Bvisa kunyoresa kamwe chete. Hatimbotengese kana kugovera kero yako.
Zviedze iwe pachako
Mhinduro yepakarepo pamhinduro yega yega, uye chitupa chinogovaniswa chine ID inobatika kana wapedza kosi.
Tsigira dzidzo yemahara yeAI. AI Understanding ndeye 501(c)(3) isingabatsiri - hapana ads, hapana paywall, zvachose. Ita chipo
Kugadzira maturusi evashandi veLLM kunoreva kunyora mazita, tsananguro, parameter schemas, zvinobuda uye mhosho meseji inoverengwa nemhando yemutauro kuti usarudze kuti nderipi basa rekudaidza uye kuti ungaridaidza sei. Iyo modhi haina kumboona kodhi yako, ichi chinyorwa chete, saka tsananguro isina kujeka kana sloppy schema inoburitsa mafoni asiri iwo akavimbika sezvinoita bug.
Iyo modhi haimbooni kushandiswa. Inoshanda chete kubva pane zvinyorwa zvemavara: zita, tsananguro, iyo schema yekupinda uye chero chishandiso chinodzosera kumashure.
Namespacing inotaurira modhi kuti chishandiso ndechepi. Izvo zvakakosha kana masevhisi akati wandei achipa zviito zvakafanana.
Enums nemazita anotsanangura anobvisa guesswork. Iyo modhi inotora kubva kune inoshanda sarudzo pane kugadzira fomati.
Iyo modhi inoverenga kukanganisa uye inosarudza zvekuita zvinotevera. Meseji inodoma dambudziko uye kugadzirisa kunoita kuti idzoke parunhare rwunotevera.
Tsanangudzo yega yega inotumirwa nechikumbiro chega chega, iyo inoshandisa mamiriro. Zvishandiso zvakafanana-zvinotaridzika zvakare zvinoita kuti zviome kune modhi kusarudza iyo chaiyo.
Ramba uchidzidza
Mamwe madhairekitori akasarudzirwa nyaya iyi
InoteveraGaidhi rinotevera
Turning OpenAPI Specs into LLM Tools
Tekinoroji