Sigurtà u Prattiki Tajba
F'din il-paġna
X’Jiftaħ il-Konnessjoni ma’ Server
Il-konnessjoni ta’ Grok ma’ servers MCP remoti tagħti lill-mudell il-kapaċità li jaġixxi fuq is-sistemi tiegħek. Din is-setgħa tiġi b’riskji, u lezzjonijiet preċedenti introduċew il-parametri li jikkontrollawha. Issa huwa ż-żmien li torganizzahom f’pożizzjoni ta’ sigurtà koerenti għall-użu fil-produzzjoni.
HTTPS u Awtentikazzjoni: Il-Fondazzjoni Mhux Negozjabbli
Ir-regola hija sempliċi: kull server MCP fil-produzzjoni għandu juża HTTPS u jirrikjedi awtentikazzjoni. xAI diġà tinforza l-ewwel punt u tiċħad kwalunkwe URL HTTP sempliċi. It-tieni, madankollu, tiddependi kompletament fuqek, u hawnhekk fejn jidħlu l-iżbalji.
Server mingħajr awtentikazzjoni huwa aċċessibbli għal kulmin jaf l-URL. Dan ifisser li kulħadd jista’ jsejjaħ l-għodod interni tiegħek, id-data tiegħek tiċċirkola mingħajr kontroll tal-aċċess, u m’għandek l-ebda mod biex traċċa min għamel xiex meta sseħħ anomaliija. L-URL mhix sigrieta: tivvjaġġa fuq in-netwerks, tispiċċa fil-logs, u tista’ tiġi stmata jekk issegwi konvenzjoni.
# Produzzjoni: DEJEM bl-awtentikazzjoni
mcp(
server_url="https://api.monentreprise.com/mcp",
server_label="interne",
authorization=f"Bearer {os.getenv('MCP_TOKEN')}"
)
# Żvilupp BISS: mingħajr awtentikazzjoni
# QATT ma tiddispjega fil-produzzjoni
mcp(
server_url="https://mcp.deepwiki.com/mcp",
server_label="deepwiki"
)
Il-ġestjoni tat-tokens issegwi erba’ dixxiplini sempliċi, iżda trid timxi magħhom matul iż-żmien. Aħżen it-tokens f’varjabbli tal-ambjent, qatt fil-kodiċi sors. Inkella, l-ewwel git push pubbliku tiegħek jibgħat it-token tiegħek lid-dinja kollha. Dawwarhom perjodikament, mill-inqas kull 90 jum. Rotazzjoni skedata tbiddel tnixxija potenzjali f’tieqa ta’ espożizzjoni limitata. Iġġenerahom bil-permessi minimi meħtieġa, sabiex token misruq għal aġent bil-qari biss ikun inutli għal kulmin jipprova jikteb. Jekk wieħed jiġi kompromess, irrevokah immedjatament qabel ma tiġġenera wieħed ġdid. L-ordni hija importanti: token irrevokat wara l-fatt jibqa’ jaħdem għaż-żmien kollu li tieħu biex tfittex is-sostitut tiegħu.
Listi ta’ Permessi bħala Tieni Linja ta’ Difiża
Token validu jipprova l-identità ta’ min qed isejjaħ; ma jgħid xejn dwar x’għandu jkun kapaċi jagħmel min qed isejjaħ. Hawnhekk fejn tidħol allowed_tool_names. Tapplika l-prinċipju tal-inqas privileġġ billi tesponi biss dak li huwa strettament meħtieġ għall-mudell.
Ir-restrizzjoni speċifika tiddependi mill-profil tal-aġent. Chatbot pubbliku jillimita ruħu għal operazzjonijiet ta’ qari biss, mingħajr l-ebda għodda ta’ kittieb fil-portata.
allowed_tool_names=["search_docs", "get_article", "list_categories"]
# L-ebda aċċess għal: create_article, update_article, delete_article
Aġent intern jista’ jaffordja aktar aċċess, inkluż li jikkummenta fuq tikketta, filwaqt li jżomm azzjonijiet irreversibbli jew azzjonijiet viżibbli għal partijiet terzi ‘l bogħod mill-portata.
allowed_tool_names=[
"search_tickets", "get_ticket", "add_comment",
# L-ebda aċċess għal: close_ticket, delete_ticket, reassign_ticket
]
Fl-aħħar nett, pipeline awtomatizzata għandha bżonn biss iż-żewġ għodod li l-fluss tax-xogħol tagħha jgħaqqad flimkien. M’hemm l-ebda ġustifikazzjoni biex terġa’ tikkonfigura xi ħaġa.
allowed_tool_names=["run_analysis", "get_results"]
# L-ebda aċċess għal: configure_pipeline, delete_results
Ix-xenarju li dawn il-listi jipproteġuk minnu huwa l-injezzjoni tal-prompt. Dokument analizzat, tikketta, jew email li tidħol tista’ fiha istruzzjoni maħsuba għall-mudell. Mingħajr restrizzjoni, din l-istruzzjoni tista’ twasslu biex iħassar data permezz ta’ għodda delete_*, jimmodifika setting permezz ta’ update_config, joħroġ komunikazzjonijiet mhux mixtieqa permezz ta’ send_email. Għodda li qatt ma ġiet esposta ma tistax tiġi ħatufa. Din hija l-unika garanzija verament soda.
Il-Kuntest Huwa Riżorsa Finita
Kull għodda esposta tikkonsma tokens fit-tieqa tal-kuntest, peress li l-isem, id-deskrizzjoni u l-iskema tal-parametri tagħha għandhom jirrisjedu hemmhekk. Server li jippubblika tletin għodda jista’ jikkonsma diversi eluf ta’ tokens qabel ma l-utent anki jistaqsi mistoqsija.
Il-konsegwenzi jidhru bi tliet modi: inqas spazju għall-konversazzjoni nnifisha, ħin ta’ pproċessar itwal minħabba l-volum li għandu jiġi analizzat, u riskju akbar ta’ konfużjoni meta għodod multipli jidhru simili. Tliet prattiki jindirizzaw dan. L-ewwel, irrestrinġi b’allowed_tool_names, li jibqa’ l-aktar leva diretta. Imbagħad, segmenta skont il-każ ta’ użu minflok ma żżomm konfigurazzjoni waħda. Aġent tas-sostenn tal-klijenti, aġent intern, u pipeline m’għandhom l-ebda raġuni biex jaqsmu l-istess katalogu. Fl-aħħar nett, evalwa mill-ġdid perjodikament. Iċċekkja t-traċċi tiegħek biex tara liema għodod qed jintużaw attwalment. Spiss issib diversi li qatt ma ntużaw iżda jkollhom kost ta’ kuntest fuq kull talba.
Deskrizzjonijiet li Jtejbu l-Preċiżjoni
Deskrizzjonijiet attenti kemm fil-livell tas-server kif ukoll tal-għodda jnaqqsu b’mod sinifikanti s-sejħiet żbaljati. Il-kuntrast hawn taħt juri d-differenza bejn deskrizzjoni użabbli u waħda inutli.
# Tajjeb: speċifiku u azzjonabbli
server_description="Bażi tal-għarfien tal-prodott. Fittex artikoli tal-għajnuna, FAQ, u gwidi għat-tiswija tal-problemi għall-prodotti A, B, u C."
# Ħażin: vag u ġeneriku
server_description="Database"
Is-sistema tal-prompt hija s-saff finali ta’ din il-konfigurazzjoni. Tippermettilek tesprimi regoli ta’ użu li l-konfigurazzjoni waħedha ma tistax tinforza, bħal ordni ta’ prijorità bejn is-sorsi jew rekwiżit ta’ konferma.
Meta l-utent jistaqsi mistoqsija teknika, ifittex l-ewwel fil-bażi tal-għarfien interna (kb).
Jekk it-tweġiba ma tinstabx, uża t-tiftix fuq il-web bħala suppliment.
Qatt ma timmodifika tikketta mingħajr konferma espliċita tal-utent.
Żomm f’moħħok, madankollu, li dawn il-linji gwida jorjentaw l-imġiba tal-mudell mingħajr ma jirrestrinġuh. Dawn jissupplixxu l-lista ta’ permessi; qatt ma jissostitwixxuha.
Punti Ewlenin
- HTTPS huwa infurzat minn xAI, iżda l-awtentikazzjoni hija r-responsabbiltà tiegħek
- Aħżen it-tokens f’varjabbli tal-ambjent u dawwarhom regolarment
- Uża
allowed_tool_namesbiex tapplika l-prinċipju tal-inqas privileġġ - Immonitorja t-tagħbija tal-kuntest: kull għodda tikkonsma tokens
- Ikteb deskrizzjonijiet preċiżi biex ittejjeb l-għażla tal-għodod ta’ Grok