Teorainneacha agus Dea-Chleachtais
Ar an leathanach seo
- Srialta teicniúla an ghlaoigh feidhme
- Uasmhéid 200 uirlis in aghaidh na hiarrata
- Ní ráthaíonn an tsamhail bailíocht na n-argóintí
- Láimhseáil earráidí
- Ainmneacha uathúla agus soiléire
- Tuairiscí: an fachtóir cáilíochta is tábhachtaí
- Líon na n-uirlisí a optamú
- Slándáil: ná bíodh muinín agat as an tsamhail riamh
- Príomhphointí
Srialta teicniúla an ghlaoigh feidhme
Sula dtosaíonn tú ar an gcur chun feidhme, ní mór duit teorainneacha an chórais a thuiscint. Tá glaoch feidhme Grok cumhachtach, ach oibríonn sé laistigh de shrianta sonraithe ar cheart duit a bheith máistir orthu chun feidhmchláir láidre a thógáil.
Uasmhéid 200 uirlis in aghaidh na hiarrata
Glacann API Grok le suas le 200 sainmhíniú uirlise in aon iarratas amháin. Tá an teorainn seo flaithiúil—úsáideann formhór na bhfeidhmchlár 5 go 20 amháin. Ach má thógann tú córas inscálaithe (breiseáin, margadh uirlisí), ní mór duit cuntas a thabhairt air seo.
Glacann gach sainmhíniú uirlise spás sa fhuinneog chomhthéacs. Go sonrach:
- Úsáideann uirlis shimplí (2-3 paraiméadar) thart ar 50-100 token
- Is féidir le huirlis chasta (10+ paraiméadar, tuairiscí mionsonraithe) dul thar 300 token
- 200 uirlis chasta = 60,000 token do shainmhínithe amháin
Sin an fáth a gcaithfidh tú a bheith straitéiseach: ní dhearbhú ach na huirlisí atá ábhartha don iarratas reatha.
Ní ráthaíonn an tsamhail bailíocht na n-argóintí
Déanann Grok a dhícheall argóintí a ghiniúint a oireann don scéama, ach níl sé gan locht. Is féidir leis an tsamhail:
- Formáid dáta mícheart a ghiniúint
stringa sheoladh nuair a bhfuilintegerag teastáil- Réimse riachtanach a fhágáil ar lár i gcásanna annamha
- Luachanna enum a bhrionglóidiú nach bhfuil ann
Ní mór do do chód taobh an chliaint na hargóintí a fhaightear a bhailíochtú i gcónaí sula ndéantar an fheidhm a fhorghníomhú.
import json
def handle_tool_call(tool_call):
args = json.loads(tool_call.function.arguments)
# Validate before execution
if "city" not in args:
return {"error": "The city parameter is required"}
if not isinstance(args["city"], str):
return {"error": "city must be a string"}
return get_weather(args["city"], args.get("unit", "celsius"))
Láimhseáil earráidí
Nuair a theipeann ar fheidhm, ní mór duit an earráid a thabhairt ar ais don tsamhail seachas titim i láthair go ciúin. Is féidir leis an tsamhail ansin:
- A hiarratas a athfhráisiú le paraiméadair cheartaithe
- An t-úsáideoir a chur ar an eolas faoin bhfadhb
- Uirlis mhalartach a thriail
try:
result = search_database(query=args["query"])
return json.dumps(result)
except ConnectionError:
return json.dumps({
"error": "Database unavailable",
"suggestion": "Retry in a few seconds"
})
Seol JSON struchtúrtha i gcónaí, fiú ar earráid. Tuigeann an tsamhail teachtaireachtaí earráide agus oiriúnaíonn sí a freagra dá réir.
Ainmneacha uathúla agus soiléire
Ní mór d’ainmneacha feidhme a bheith uathúil sa liosta uirlisí. Má roinneann dhá uirlis an t-ainm céanna, tá an iompar neamhshainithe; d’fhéadfadh an API an t-iarratas a dhiúltú nó ceann acu a neamhaird.
Glac le coinbhinsiún ainmnithe comhsheasmhach:
✅ Dea-chleachtais:
get_weather → aisghabháil sonraí
search_products → cuardach
create_ticket → cruthú
update_order_status → nuashonrú
delete_draft → scriosadh
❌ Seachain:
fn1, fn2 → dofheicthe
doStuff → ró-ghinearálta
getWeatherData → camelCase (is fearr snake_case)
Tuairiscí: an fachtóir cáilíochta is tábhachtaí
Braitheann iontaofacht an ghlaoigh feidhme go díreach ar cháilíocht na dtuairiscí. Seo tábla comparáide:
| Tuairisc lag | Tuairisc éifeachtach |
|---|---|
| "Search" | "Search for products by name, category, or price range in the e-commerce catalog" |
| "Send message" | "Send an email to a recipient. Requires a subject and message body. Does not support attachments." |
| "Calculate" | "Calculate the total price including tax from a pre-tax price and a VAT rate. Returns the amount in euros with 2 decimal places." |
Líon na n-uirlisí a optamú
In ionad 200 uirlis a dhearbhú ar gach iarratas, roghnaigh go dinimiciúil iad siúd a bhfuil tábhacht leo i ndáiríre. Is é an chéad scagaire ná an comhthéacs: má labhraíonn an t-úsáideoir faoin aimsir, ní chuireann uirlisí billeála ach torann leis; tá bealachú éadrom suas an srutha (de réir eochairfhocail nó glao aicmithe tosaigh) leordhóthanach chun an teaghlach ábhartha amháin a chur i láthair. Is é an dara scagaire ná an ról: ní gá uirlisí riaracháin do ghníomhaire tacaíochta, agus is ábhar cruinnis chomh maith le slándála iad a bhaint. Is é an tríú scagaire ná an chéim: i sruth oibre ilchéime, tá a uirlisí féin ag gach céim; má lódálann tú iad de réir mar a théann tú ar aghaidh, coinníonn tú an tsamhail dírithe ar an rud atá le déanamh aici anois.
Tá an sochar dúbailte agus láithreach: níos lú token ionchuir in aghaidh na hiarratais (costaíonn sainmhínithe uirlisí ort ar gach glao), agus cruinneas roghnúcháin níos fearr—is annamh a dhéanann samhail a roghnaíonn as sé uirlis atá curtha síos go maith botún, ach deireann an tsamhail chéanna agus dhá chéad sainmhíniú os a comhair trí mheascadh suas leaganacha atá cosúil le chéile.
Slándáil: ná bíodh muinín agat as an tsamhail riamh
Is veicteoir insteallta féideartha é glaoch feidhme. D’fhéadfadh úsáideoir mailíseach a n-iarratas a fhráisiú chun na hargóintí a sheoltar chuig feidhmeanna a láimhseáil. Rialacha slándála:
- Bailíochtaigh gach argóint ar an taobh freastalaí
- Teorainn a chur le ceadanna: ní chóir go mbeadh feidhm léitheoireachta in ann scríobh
- Logáil glaonna: rianaigh gach glao feidhme chun críche iniúchta
- Glan ionchuir: éalaigh carachtair speisialta sula ndéantar iarratais SQL/shell
Príomhphointí
- Uasmhéid 200 uirlis in aghaidh na hiarratais—ach díriú ar 5-20 chun éifeachtúlachta
- Bailíochtaigh na hargóintí taobh an chliaint i gcónaí sula ndéantar iad a fhorghníomhú
- Seol earráidí ar ais don tsamhail i JSON struchtúrtha
- Ní mór d’ainmneacha a bheith uathúil, i snake_case, agus soiléir
- Feabhsaíonn tuairiscí mionsonraithe an iontaofacht go mór
- Roghnaigh uirlisí ábhartha go dinimiciúil do gach iarratas
- Ná bíodh muinín agat as argóintí gan bhailíochtú