Dea-chleachtais agus Léiriú i dTáirgeadh
Ar an leathanach seo
- Ó Chruthúnas Coincheapa go dtí an Táirgeadh
- Seicliosta Imscartha
- Cur síos a Scríobh a Chuireann an Múnla ag Obair
- An Múnla Ceart a Roghnú
- An Teachtaireacht Chórais a Struchtúrú
- Costais a Bhainistiú i dTáirgeadh
- Tástáil Glaonna Feidhme
- Monatóireacht i dTáirgeadh
- Na Chéad Chéimeanna Eile
- Príomhphointí
- Tástáil do Chuid Eolais
Ó Chruthúnas Coincheapa go dtí an Táirgeadh
Tá na bloic thógála go léir agat anois chun córais glaonna feidhme a thógáil le Mistral. Ní gnéithe atá in easnamh a dhealraíonn do phrótaitíopa ó sheirbhís atá réidh don táirgeadh, ach sraith seiceálacha agus céimeanna tiúntha a aimsíonn tú de ghnáth le linn teagmhais. Tugann an ceacht deireanach seo le chéile dea-chleachtais, paiteanna coitianta, agus seicliosta chun bogadh chuig an táirgeadh le muinín.
Seicliosta Imscartha
Seo an t-aon áit sa chúrsa seo a bhfuil formáid liosta éigeantach: sula dtéann tú beo, seiceálann tú boscaí. Caithfear ceithre fhearann a chlúdach, agus freagraíonn gach ceann acu ar cheist eile.
Cinntíonn Ailtireacht go seasann na meicnic. Is iad sreangáin JSON a thabhairt ar ais sa slabhra agus foclóir seolta iomlán a bheith agat an dá chúis is minice a bhíonn le titim amach ar an gcéad ghlaog fíor.
- Filltear sreangáin JSON ó gach feidhm (ná fill rudaí Python amh riamh)
- Tá an foclóir seolta iomlán agus cothrom le dáta
- Láimhseálann feidhmeanna cásanna earráide agus filltear teachtaireachtaí inúsáidte
- Tá an teachtaireacht chórais soiléir, cruinn, agus tástáilte
- Láimhseálann an lúb comhrá glaonna seicheamhacha agus comhthreomhara
Glacann Slándáil leis go dtagann argóintí ó úsáideoir, ní ó d’fheidhmchlár féin.
- Déantar bailíochtú ar argóintí sula ndéantar iad a fhorghníomhú (formáid, cineál, luachanna)
- Úsáideann ceisteanna SQL paraiméadair (gan comhcheangal)
- Cuireann liosta bán teorainn le feidhmeanna atá ar fáil
- Éilíonn gníomharth millteacha deimhniú
- Tá teorannú ráta i bhfeidhm in aghaidh gach feidhme agus in aghaidh gach úsáideora
- Déantar glanadh ar thorthaí (gan sonraí íogaire a thabhairt ar ais don mhúnla)
Láimhseálann Iontaofacht rud a theipeann gan aon locht a bheith ar dhuine ar bith.
- Filleann earráidí chuig an mhúnla i bhformáid struchtúraithe
- Cuirtear iarracht athfhillte le cúlú (backoff) i bhfeidhm le haghaidh earráidí sealadacha
- Cumraítear amanna teorainn do gach feidhm sheachtrach
- Teorannaítear méid na staire chun sárú token a sheachaint
Is é Monatóireacht, ar deireadh, an rud a ligeann duit diagnóis a dhéanamh gan buille faoi thuairim a thabhairt.
- Déantar logáil ar gach glaog feidhme (ainm, argóintí, toradh, fad)
- Spreagann earráidí foláirimh (Slack, PagerDuty, srl.)
- Bailítear méadrachtaí (ráta ratha, moill, costas API)
Cur síos a Scríobh a Chuireann an Múnla ag Obair
Tá tionchar díreach ag cáilíocht an chur síos ar chruinneas, agus is minic gurb é an luamhán is saoire le tarraingt. Tagann trí phatrún chun cinn go minic i measc foirne a bhfuil rátaí glaonna cearta ard acu. Cuireann an chéad cheann an cur síos i gcomhthéacs gnó: in ionad ainm na feidhme a pharaphrásiú, liostaigh luachanna féideartha fillte agus ráigh go sainráite cathain ba chóir é a ghlaow. Sleamhnaíonn an dara ceann samplaí formáide isteach i gcur síos an pharaiméadair, rud a shocraíonn formhór na n-earráidí eastósctha ID. Cuireann an tríú ceann treoir teanga nádúrtha in ionad enum, an t-aon bhealach chun luach lasmuigh den liosta a thoirmeasc go hiomlán.
# Pattern 1: Description with business context
{
"description": "Retrieves payment status. "
"Possible statuses: paid, pending, failed, refunded. "
"Use this function when the user asks "
"about a payment's status or whether it was received."
}
# Pattern 2: Parameters with examples
{
"transaction_id": {
"type": "string",
"description": "Unique ID in format T followed by 4 digits (e.g., T1001, T2345)"
}
}
# Pattern 3: Enum for limited values
{
"status": {
"type": "string",
"enum": ["paid", "pending", "failed", "refunded"],
"description": "Filter by payment status"
}
}
An Múnla Ceart a Roghnú
Baineann roghnú an mhúnla le malartú idir cruinneas agus costas, agus níl aon fhreagra uilíoch ann: braitheann sé ar líon na bhfeidhmeanna nochtaithe agus ar chastacht a scéimre. Údaróidh cás casta le go leor feidhmeanna agus paraiméadair neadaithe Mistral Large 3, atá níos iontaofa maidir le roghnú feidhme ach níos costasaí. Riteann cás caighdeánach le cúpla feidhm shimplí i dtáirgeadh ard-thorthúlachta go han-mhaith ar Mistral Small 4, atá tapa agus eacnamaíoch. Maidir le prototyping agus tástáil, tairgeann Mistral Medium 3.5 comhréir mhaith.
# Complex cases: many functions, nested parameters
# -> Mistral Large 3 (more reliable, more expensive)
model = "mistral-large-latest"
# Standard cases: few simple functions, high-throughput production
# -> Mistral Small 4 (fast, economical)
model = "mistral-small-latest"
# Development cases: prototyping, testing
# -> Mistral Medium 3.5 (good compromise)
model = "mistral-medium-latest"
Tá an modh chomh tábhachtach leis an toradh: i dtáirgeadh, tosaigh leis an múnla is cumasaí, tomhais do ráta glaonna cearta, agus ansin téigh síos de réir a chéile chun an cóimheas costais/feidhmíochta is fearr a aimsiú. Diúltaíonn an contrárthacht – tosú leis an múnla is saoire – an bonnlíne duit chun a fháil amach an dtagann díghrádú ón múnla nó ó do chur síos.
An Teachtaireacht Chórais a Struchtúrú
Déanann teachtaireacht chórais mhaith an difríocht idir cúntóir measartha agus ceann den scoth. Léiríonn an ceann seo struchtúr cruthaithe: ráiteas róil, bloc de rialacha éigeantacha, agus ansin cuimhneachán ar na huirlisí atá ar fáil. Is iad an dá riail is cost-éifeachtaí anseo ná “Mura soláthraíonn an t-úsáideoir ID riachtanach, iarr go cúirtéiseach é” agus “Ná tuar ID idirbhirt riamh” – le chéile, díothaíonn siad an iompar is damáistí de na hiomláin, glaog a dhéanamh ar fheidhm le ID bréagach.
system_message = {
"role": "system",
"content": """You are a payment management assistant for Acme Corporation.
Rules:
- Always respond in English
- Format amounts in euros with the symbol and 2 decimal places
- If the user doesn't provide a required ID, ask politely
- Never guess a transaction ID
- When a transaction fails, offer to check the details
Available tools:
- retrieve_payment_status: to check a payment's status
- retrieve_payment_date: to check a payment's date
- retrieve_payment_details: to get all details of a transaction
- list_customer_transactions: to view all transactions for a customer"""
}
Costais a Bhainistiú i dTáirgeadh
Caitheann gach glaog glaonna feidhme token, agus éiríonn an bille trí dhá chainéal a ndéantar neamhaird orthu go minic: seoltar sainmhínithe uirlisí le gach iarratas, agus fásann an stair le gach casadh. Réitíonn scagadh feidhme de réir comhthéacs an chéad phointe – níl aon ghá le gach ceann de na dhá uirlis dhéag a sheoladh nuair is léir go mbaineann an cheist le híocaíochtaí. Réitíonn gearradh na staire thar tairseach an dara pointe. Agus nuair atá na sonraí riachtanacha go léir sa chomhthéacs cheana féin, seachnaíonn tool_choice="none" turas breise.
# 1. Limit the number of functions per request
# Pass only functions relevant to the context
def get_relevant_tools(user_input: str, all_tools: list) -> list:
"""Filters tools based on context."""
if "payment" in user_input.lower() or "transaction" in user_input.lower():
return [t for t in all_tools if "payment" in t["function"]["name"]]
if "contact" in user_input.lower() or "customer" in user_input.lower():
return [t for t in all_tools if "contact" in t["function"]["name"]]
return all_tools
# 2. Limit history size
MAX_HISTORY = 20 # messages
# 3. Use tool_choice="none" when data is already available
Tástáil Glaonna Feidhme
Tá tástálacha riachtanach chun regresses a sheachaint, agus sa chás seo dírithe ar réad neamhghnách: ní do luach fillte do fheidhme féin atá tú ag seiceáil, ach cinneadh an mhúnla. Clúdaíonn dhá theaghlach tástála na bunriachtanais. Fíoraíonn an chéad cheann go spreagann ceist ghnó an fheidhm cheart leis na hargóintí eastósctha cearta. Fíoraíonn an dara ceann, atá chomh tábhachtach céanna agus a dhéantar dearmad air go minic, nach spreagann beannú aon ghlaog – gabhann an tástáil seo cur síos atá ró-leathan a bhrúnn an múnla chun feidhm a ghlaow i ngach imthoisc.
def test_payment_status():
"""Tests that the model calls the right function."""
messages = [{"role": "user", "content": "Status of payment T1001?"}]
response = client.chat.complete(
model=model, messages=messages, tools=tools
)
message = response.choices[0].message
assert message.tool_calls is not None
assert len(message.tool_calls) == 1
assert message.tool_calls[0].function.name == "retrieve_payment_status"
args = json.loads(message.tool_calls[0].function.arguments)
assert args["transaction_id"] == "T1001"
def test_no_function_for_greeting():
"""Tests that the model doesn't call a function for a greeting."""
messages = [{"role": "user", "content": "Hello!"}]
response = client.chat.complete(
model=model, messages=messages, tools=tools
)
message = response.choices[0].message
assert message.tool_calls is None or len(message.tool_calls) == 0
assert message.content is not None
Monatóireacht i dTáirgeadh
Anois ní mór duit a fháil amach cad atá do chóras a dhéanamh nuair a scaoiltear sa saol mór é. Comhcheanglaíonn an rang thíos trí chomhartha a insíonn an scéal beagnach iomlán le chéile: ráta ratha foriomlán, moill mheánach, agus briseadh síos de réir feidhme. Is é an ceann deireanach an ceann is suntasaí sa chleachtas – léiríonn feidhm a bhfuil a cuntair earráide ag imeacht go haonarach fadhb shonrach, ach ní insíonn ráta foriomlán laghdaithe duit cá háit le breathnú.
import time
import logging
logger = logging.getLogger("fc_monitor")
class FunctionCallingMonitor:
def __init__(self):
self.metrics = {
"total_calls": 0,
"successful_calls": 0,
"failed_calls": 0,
"total_latency_ms": 0,
"calls_by_function": {}
}
def record(self, function_name: str, success: bool, latency_ms: float):
self.metrics["total_calls"] += 1
self.metrics["total_latency_ms"] += latency_ms
if success:
self.metrics["successful_calls"] += 1
else:
self.metrics["failed_calls"] += 1
if function_name not in self.metrics["calls_by_function"]:
self.metrics["calls_by_function"][function_name] = {
"count": 0, "errors": 0
}
self.metrics["calls_by_function"][function_name]["count"] += 1
if not success:
self.metrics["calls_by_function"][function_name]["errors"] += 1
def get_success_rate(self) -> float:
if self.metrics["total_calls"] == 0:
return 0.0
return self.metrics["successful_calls"] / self.metrics["total_calls"]
def get_avg_latency(self) -> float:
if self.metrics["total_calls"] == 0:
return 0.0
return self.metrics["total_latency_ms"] / self.metrics["total_calls"]
monitor = FunctionCallingMonitor()
Na Chéad Chéimeanna Eile
Anois go bhfuil máistreacht faighte agat ar ghlaonna feidhme le Mistral, osclaíonn roinnt treo. Is é an ceann is nádúrtha ná gníomhairí uathrialacha a thógáil, ag comhcheangal glaonna feidhme le lúb gníomhaire a dhéanann pleanáil agus a fhorghníomhaíonn tascanna casta; téann API Mistral Agents agus a client.beta.agents.create() níos faide trí ghníomhairí buana le stát a thairiscint. Comhcheanglaíonn ais eile RAG agus glaonna feidhme: cinneann an múnla é féin cathain ceist a chur ar bhunachar sonraí veicteora, in ionad cuardach a bheith spreagtha go córasach thuas an sruth. Ar thaobh thaithí an úsáideora, ligeann sruthú duit freagraí a thaispeáint i bhfíor-am agus feidhmeanna á bhforghníomhú, rud a athraíonn an tuiscint ar mhoill ar shlabhraí glaonna fada. Ar deireadh, osclaíonn ilmhóideach glaonna feidhme don radharc chun anailís a dhéanamh ar dhoiciméid.
Príomhphointí
- Clúdaíonn an seicliosta imscartha ailtireacht, slándáil, iontaofacht, agus monatóireacht
- Feabhsaíonn cur síos cruinn le samplaí agus enums cruinneas an mhúnla
- Roghnaigh an múnla ceart bunaithe ar chastacht agus buiséad (Large d’iontaofacht, Small do thorthúlacht)
- Is luamhán cumhachtach é an teachtaireacht chórais chun iompar a threorú
- Tástáil glaonna feidhme agus iompar gan fheidhm go córasach
- Déan monatóireacht ar ráta ratha, moill, agus costais i dtáirgeadh
Tástáil do Chuid Eolais
Glaonna feidhme ó thús go deireadh: cúig sheiceáil.
1. Cad iad na cúig chéim de ghlaonna feidhme?
Freagra: Sainmhínigh feidhmeanna (scéimre), soláthair iad don API, iarrann an múnla glaog lena argóintí, forghníomhaíonn do chód agus filleann sé an toradh, cruthaíonn an múnla an fhreagra deiridh.
2. Cad a dhéanann scéimre feidhme maith?
Freagra: Cineálacha docht agus cur síos oibríochtúla – ainm soiléir, cathain é a úsáid, formáid gach paraiméadair: is é seo an téacs a léann an múnla chun cinneadh a dhéanamh agus é a líonadh isteach.
3. Cad a chuireann glaonna comhthreomhara ar chumas?
Freagra: Iarrann an múnla iliomad feidhmeanna in aon fhreagra amháin nuair atá siad neamhspleách – níos lú turas, ar choinníoll go meaitseálann tú gach toradh lena ghlaog féin.
4. Cad é tool_choice?
Freagra: Chun saoirse an mhúnla a shocrú: auto (cinneann sé), any (caithfidh sé uirlis a úsáid), nó uirlis fhorchurtha – is é an ceann deireanach an eochair d’eastóscadh struchtúraithe iontaofa.
5. Cad iad na rialacha slándála do fheidhmeanna nochtaithe?
Freagra: Déan bailíochtú ar argóintí a fuarthas, teorannaigh scóip gach feidhme, déan logáil ar ghlaonna, agus coinnigh bailíochtú daonna ar ghníomhartha a chur i gcrích – molann an múnla, déanann do chód an cinneadh deiridh.
Baineann an dá shampla oibre sa chúrsa seo (rianaitheoir íocaíochta, CRM) go díreach leis na rialacha seo – leanfaidh do chomhtháthuithe féin an múnla céanna.