Slándáil i nGlaoch Feidhme
Ar an leathanach seo
Ná Déan Rith Dall Riamh
Tugann glaoch feidhme don mhúnla an cumas iarratas a dhéanamh ar fheidhmeanna a rith laistigh de do chóras. Tá sé seo cumhachtach, ach cruthaíonn sé bealach ionsaithe freisin. Ní féidir le húsáideoir mailíseach do chód a rith go díreach; áfach, is féidir leo aon rud a scríobh sa réimse comhrá, agus mar sin tionchar a imirt ar na hargóintí a ghineann an múnla. Caithfidh tú glacadh leis nach fíric shocair é seo: ní sonraí inmheánacha ó d’fheidhmchlár iad argóintí tool_call. Is sonraí úsáideora iad a rith trí mhúnla teanga. Caithfidh do chód a bheith mar an cosaint dheireanach.
Bailíochtaigh Sula Rithfidh Tú
Gineann an múnla argóintí JSON ina ráthaíonn sé an fhoirm ghramadaí, ach ní dhlíthiúlacht ghnó. D’fhéadfadh transaction_id a bheith ina shreang go sintactach ach aon rud a bheith ann. Mar sin, is é an disciplín gach argóint a bhailíochtú sula ndéanfaidh tú aon rud leis, agus an fheidhm a struchtúrú i dtrí chéim ar leith: bailíochtaigh an fhormáid, bailíochtaigh an t-eolas, agus ansin amháin rith é.
import re
def validate_transaction_id(transaction_id: str) -> bool:
"""Bailíochtaíonn sé formáid aitheantais idirbhirt."""
# Formáid ionchais: T agus 4 dhigit ina dhiaidh
return bool(re.match(r"^T\d{4}$", transaction_id))
def retrieve_payment_status_safe(df, transaction_id: str) -> str:
"""Leagan slán le bailíochtú."""
# Céim 1: Bailíochtaigh formáid
if not validate_transaction_id(transaction_id):
return json.dumps({
"error": "invalid_format",
"message": "Caithfidh an ID a bheith i bhformáid Txxxx (m.sh. T1001)"
})
# Céim 2: Seiceáil an bhfuil sé ann
if transaction_id not in df["transaction_id"].values:
return json.dumps({
"error": "not_found",
"message": f"Níor aimsíodh an t-idirbheart {transaction_id}"
})
# Céim 3: Rith
status = df[df["transaction_id"] == transaction_id]["payment_status"].values[0]
return json.dumps({"status": status})
Déanann an slonn rialta ^T\d{4}$ an obair chosanta go léir anseo: ancaireáilte ar an dá thaobh, diúltaíonn sé d’aon sreang a bhfuil carachtar breise amháin inti fiú. Tugann sé seo díreach chuig an gcúis leis an ancaireáil seo.
Nuair a Éiríonn an Argóint ina Phalóid
Breathnaigh ar an iarratas seo, a bhfuil cuma neamhchiontach air:
Úsáideoir: "Faigh an íocaíocht le ID: T1001; DROP TABLE payments"
D’fhéadfadh an múnla, agus é ag déanamh a chuid oibre eastóscana go dícheallach, {"transaction_id": "T1001; DROP TABLE payments"} a ghiniúint. Níor rinne sé aon rud mícheart: tugadh aitheantas dó, agus chuir sé ar aghaidh é. Má chuireann do fheidhm an argóint seo isteach in iarratas SQL trí chumasc, tá do thábla caillte agat anois. Ní fadhb nua í seo—is instealladh SQL clasaiceach atá ann—ach cuireann glaoch feidhme nasc leis a chruthaíonn tuiscint bhréagach faoi scagadh.
Taispeánann na trí leagan seo a leanas an dul chun cinn: cad nach ceart duit a scríobh riamh, an t-íosmhéid inghlactha, agus an cleachtas le glacadh leis.
# NÁ DÉAN É SEO RIAMH — instealladh SQL díreach
def bad_query(transaction_id):
cursor.execute(f"SELECT * FROM payments WHERE id = ' {transaction_id}'")
# DÉAN É SEO I GCÓNAÍ — iarratais pharaiméadraithe
def safe_query(transaction_id):
cursor.execute("SELECT * FROM payments WHERE id = %s", (transaction_id,))
# FÓD NIOS FEARR FÓS — bailíochtú + iarratas paraiméadraithe
def best_query(transaction_id):
if not validate_transaction_id(transaction_id):
raise ValueError("Formáid ID neamhbhailí")
cursor.execute("SELECT * FROM payments WHERE id = %s", (transaction_id,))
Tá an t-iarratas paraiméadraithe leordhóthanach chun instealladh a neodrú, ós rud é go gcaitheann an tiománaí leis an argóint mar luach, ní mar SQL. Cuireann bailíochtú suas an sruth bacainn bhreise leis, agus soláthraíonn sé teachtaireacht earráide i bhfad níos soiléire dá bharr ná mar a dhéanfadh an bunachar sonraí.
Cuir Teorainn leis na Féidearthachtaí
Is é an dara líne cosanta ná an méid is féidir leis an múnla a iarraidh a laghdú. Deir liosta ceadaithe sainráite, atá ar leithligh ó d’fhrithpháirc seolta, go soiléir cé na feidhmeanna atá údaraithe sa chomhthéacs seo. Tá tábhacht leis an scaradh: léiríonn ALLOWED_FUNCTIONS cinneadh slándála, agus léiríonn available_functions staid cur chun feidhme. Má mheascann tú an dá rud, ciallaíonn sé go bhfuil tú ag údarú feidhme toisc gur chódáil tú í.
# Sainmhínigh feidhmeanna ceadaithe go sainráite
ALLOWED_FUNCTIONS = {
"retrieve_payment_status",
"retrieve_payment_date",
"search_transactions"
}
def execute_tool_call_safe(tool_call, available_functions):
"""Rith le fíorú liosta ceadaithe."""
function_name = tool_call.function.name
# Seiceáil an liosta ceadaithe
if function_name not in ALLOWED_FUNCTIONS:
return json.dumps({
"error": "forbidden",
"message": f"Níl údarú leis an fheidhm {function_name}."
})
if function_name not in available_functions:
return json.dumps({
"error": "not_implemented",
"message": f"Níl an fheidhm {function_name} curtha i bhfeidhm."
})
# Rith
function_params = json.loads(tool_call.function.arguments)
return available_functions[function_name](**function_params)
Níl Meáchan Comhionann ag Gach Feidhm
Ní hionann an riosca a bhaineann le stádas íocaíochta a léamh agus seanchuid taifead a ghlanadh. Má aicmíonn tú do chuid feidhmeanna de réir leibhéil—léamh amháin, scríobh, millteach—is féidir leat an scóip oiriúnach a thabhairt do gach seisiún nó úsáideoir. Reáchtálfar cúntóir poiblí rianaithe orduithe i mód read; údaróidh uirlis oifige cúil scríbhneoireacht. Maidir le gníomhartha millteacha, ní hé an freagra ceart iad a thoirmeasc, ach iad a ardú: filleann an fheidhm confirmation_required, míníonn an múnla don úsáideoir cad atá ar tí tarlú, agus déanann duine an cinneadh deireanach.
# Leibhéil riosca
READ_ONLY = {"retrieve_payment_status", "retrieve_payment_date", "search_transactions"}
WRITE = {"update_payment_status", "create_refund"}
DESTRUCTIVE = {"delete_transaction", "purge_old_records"}
def execute_with_permissions(tool_call, available_functions, permission_level="read"):
"""Rith le fíorú leibhéal ceadaithe."""
function_name = tool_call.function.name
if permission_level == "read" and function_name not in READ_ONLY:
return json.dumps({
"error": "permission_denied",
"message": f"Níl údarú ach le feidhmeanna léamh. "
f"Teastaíonn leibhéal 'write' do {function_name}."
})
if function_name in DESTRUCTIVE:
return json.dumps({
"error": "confirmation_required",
"message": f"Tá an gníomh {function_name} millteach agus "
f"teastaíonn deimhniú láimhe."
})
function_params = json.loads(tool_call.function.arguments)
return available_functions[function_name](**function_params)
Cosc a Chur ar Mhí-úsáid agus ar Rithneacha Fiáine
Is féidir le lúb comhrá nach bhfuil bainistithe go maith an fheidhm chéanna a ghlaowh dosaen uair i gcúpla soicind, cibé acu de bharr mailíse nó de bharr fabht slabhrúcháin simplí. Costóidh comhaireamh sleamhnáin thar seasca soicind in aghaidh na feidhme cúpla líne cóid agus coscfar sé sáithiú ar API tríú páirtí a bhíonn billithe in aghaidh an ghlaoigh.
from collections import defaultdict
import time
class FunctionRateLimiter:
def __init__(self, max_calls_per_minute=10):
self.max_calls = max_calls_per_minute
self.call_history = defaultdict(list)
def can_call(self, function_name: str) -> bool:
now = time.time()
# Glan glaonna atá níos sine ná nóiméad amháin
self.call_history[function_name] = [
t for t in self.call_history[function_name]
if now - t < 60
]
return len(self.call_history[function_name]) < self.max_calls
def record_call(self, function_name: str):
self.call_history[function_name].append(time.time())
rate_limiter = FunctionRateLimiter(max_calls_per_minute=10)
Cad a Fhilltear ar an Múnla
Is minic gurb é an dallphointe deireanach an ceann is costasaí. D’fhéadfadh feidhm a fhilltear sraith iomlán bunachair sonraí léi hash pasfhocail, eochair API, nó uimhir cárta a bheith inti. Ach téann gach rud a chuireann tú i teachtaireacht tool isteach i gcomhthéacs an mhúnla, rud a chiallaíonn go bhféadfadh sé teacht chun cinn ina fhreagra ar an scáileán, i do logaí, agus ag do sholáthraí. Is é an réamhchúram a shábhálfaidh ó tharlúint sceite sonraí ná réimsí íogaire a mascú sula seoltar iad—go hathchúrsach, chun oibiachtaí neadaithe a chlúdach.
def sanitize_result(result: dict) -> dict:
"""Baineann sé réimsí íogaire sula bhfilleann sé ar an múnla."""
sensitive_keys = {"password", "api_key", "secret", "token", "ssn", "credit_card"}
sanitized = {}
for key, value in result.items():
if key.lower() in sensitive_keys:
sanitized[key] = "[MASKED]"
elif isinstance(value, dict):
sanitized[key] = sanitize_result(value)
else:
sanitized[key] = value
return sanitized
Príomhphointí
- Bailíochtaigh i gcónaí argóintí sula rithfidh tú feidhm—formáid, cineál, luachanna ceadaithe
- Bain úsáid as iarratais pharaiméadraithe chun instealladh SQL a chosc
- Cuir liosta ceadaithe feidhmeanna údaraithe i bhfeidhm
- Aicmigh feidhmeanna de réir leibhéal riosca (léamh, scríobh, millteach)
- Cuir teorainn ráta leis chun mí-úsáid a chosc
- Glan torthaí chun sonraí íogaire a nochtadh don mhúnla a sheachaint