Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Ċavetta tal-API u Varjabbli tal-Ambjent

Lezzjoni 5 / 16 Aġġornat 2 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Ikseb iċ-Ċavetta tal-API ta’ Mistral Tiegek
  2. Tliet Metodi ta’ Konfigurazzjoni
  3. Ordni ta’ Prijorità
  4. Sigurtà taċ-Ċavetta tal-API
  5. Ivverifika li ċ-Ċavetta Taħdem
  6. Punti Ewlenin

Lezzjoni aġġornata fit-2 ta’ Novembru 2026 abbażi ta’ API keys and profiles: iċ-ċavetta daħħalt waqt l-installazzjoni tmur fil-keychain tas-sistema (il-fajl ~/.vibe/.env huwa biss backup), il-login permezz tal-browser huwa offrut b’mod predefinit, u /status jew /whoami jindikaw is-sors użat. Sors: API keys and profiles.

Ikseb iċ-Ċavetta tal-API ta’ Mistral Tiegek

Biex tuża Vibe, għandek bżonn ċavetta tal-API ta’ Mistral. Din iċ-ċavetta tawtentika t-talbiet tiegħek u tippermetti lil Vibe jikkomunika mal-mudelli ta’ Mistral. Mingħajrha, l-għodda tinstalla u tniedi, iżda l-ebda ġenerazzjoni ma tkun possibbli. Toħloq iċ-ċavetta fuq il-Konsoll ta’ Mistral f’sitt passi:

  1. Mur fuq console.mistral.ai
  2. Oħloq kont jew idħol
  3. Immur fit-taqsima API Keys
  4. Ikklikkja Create new key
  5. Agħtiha isem deskrittiv (eż. “vibe-cli-dev”)
  6. Ikkopja ċ-ċavetta immedjatament—mhux se tintwera mill-ġdid

Dak l-aħħar punt mhuwiex formalità: iċ-ċavetta tidher darba biss. Jekk tagħlaq it-tab kmieni wisq, ikollok toħloq waħda ġdida. Iċ-ċavetta ssegwi l-format sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx u trid tibbaża kunfidenzjali. Kulmin ikollha jista’ juża l-kwota tal-API tiegħek—u għalhekk jonfoq il-baġit tiegħek.

Tliet Metodi ta’ Konfigurazzjoni

Vibe jaċċetta tliet modi biex tipprovdi din iċ-ċavetta. L-għażla tiegħek tiddependi għalkollox fuq il-kuntest tax-xogħol tiegħek.

Metodu 1: Setup Interattiv

Dan huwa l-metodu predefinit fl-ewwel tniedija u l-aktar sempliċi għal workstation personali. Vibe jistaqsik direttament għaċ-ċavetta tiegħek u jissalvaha:

vibe
# → "Please enter your Mistral API key:"
# Ippastejja ċ-ċavetta tiegħek, agħfas Enter

Iċ-ċavetta tinħażen fil-keychain tas-sistema tiegħek (macOS Keychain, Windows Credential Manager…). Jekk ma jkun hemm l-ebda keychain disponibbli, isir fallback għall-fajl ~/.vibe/.env, li huwa aċċessibbli biss minnek. Innota li fl-ewwel tniedija, il-login permezz tal-browser bil-kont ta’ Mistral tiegħek spiss ineħħi l-ħtieġa għal ċavetta għalkollox. Biex tara liema sors qed juża Vibe attwalment, ikteb /status jew /whoami matul sessjoni.

# Jekk iċ-ċavetta tkun fil-fajl .env (l-ebda keychain disponibbli)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...

Metodu 2: Varjabbli tal-Ambjent

Hekk kif toħroġ mill-ambjent tal-workstation personali—bħal pipeline CI/CD, skript awtomatizzat, jew server kondiviż—varjabbli tal-ambjent issir preferibbli għax ma tikteb xejn fuq id-disk:

export MISTRAL_API_KEY="sk-your-key-here"

Biex tagħmilha persistenti fuq il-magna tiegħek, żid din il-linja fil-fajl tal-konfigurazzjoni tal-shell tiegħek:

# F' ~/.bashrc, ~/.zshrc, jew ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"

Il-varjabbli tal-ambjent tieħu prijorità fuq il-fajl .env. Dan jippermetti mudell ta’ użu prattiku ħafna: tibdel iċ-ċavetti temporanjament mingħajr ma tagħmel bidliet permanenti. Tista’ taħdem biċ-ċavetta tal-iżvilupp tiegħek, imbagħad tippreċedi kmand wieħed b’ċavetta differenti għal operazzjoni sensittiva:

# Ċavetta tal-iżvilupp
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"

# Ċavetta tal-produzzjoni (temporanja)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"

Metodu 3: Fajl config.toml

Fl-aħħar nett, tista’ tirreferenzja l-varjabbli tal-ambjent fil-fajl tal-konfigurazzjoni TOML ta’ Vibe:

# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"

Innota li dan il-parametru ma fihx iċ-ċavetta nnifisha, iżda biss l-isem tal-varjabbli biex taqra. Din l-indirezzjoni tagħmel sens meta taħdem ma’ fornituri multipli, kull wieħed bil-varjabbli tiegħu stess: api_key_env_var jgħid lil Vibe liema wieħed juża għaċ-ċavetta predefinita.

Ordni ta’ Prijorità

Meta metodi multipli jiġu kkonfigurati simultanjament, Vibe japplika dan l-ordni:

  1. Varjabbli tal-ambjent MISTRAL_API_KEY (jekk iddefinita fil-shell)
  2. Fajl .env f’~/.vibe/.env
  3. Keychain tas-sistema, fejn il-magħżel tal-installazzjoni jħażen iċ-ċavetta

Għal fornitur personalizzat, api_key_env_var f’config.toml sempliċiment jindika l-varjabbli biex taqra, u jsegwi l-istess ordni.

Ftakar fl-ewwel linja hawn fuq: jekk talba tonqos mill-awtentikazzjoni anke jekk il-.env tiegħek fiha ċavetta valida, l-ewwel iċċekkja jekk hemmx varjabbli antika qed titħalla fil-shell tiegħek u tikserha.

Sigurtà taċ-Ċavetta tal-API

L-ewwel regola hija li qatt ma tagħmel commit taċ-ċavetta tiegħek f’repożitorju Git. Żid .env mal-.gitignore tiegħek qabel ma toħloq il-fajl. Sigriet imbuttat lejn repo pubbliku jitqies kompromess, anke jekk tħassar il-commit aktar tard. Bl-istess loġika, ma taqsamx iċ-ċavetta tiegħek b’test ċar f’messaġġ jew dokument. Jekk tissuspetta tnixxija, erġa’ oħloqha immedjatament.

Organizzattivament, uża ċavetti separati għall-iżvilupp u l-produzzjoni. Jekk waħda tnixxi, tista’ tirrevokaha mingħajr ma tinterrampi l-oħra. Fl-aħħar nett, stabbilixxi limiti ta’ nfiq fuq il-Konsoll ta’ Mistral. Din hija x-xibka tas-sigurtà l-aktar effettiva kontra skript li jdur f’loop jew ċavetta esposta: il-fatturazzjoni tieqaf awtomatikament.

Ivverifika li ċ-Ċavetta Taħdem

Wara l-konfigurazzjoni, tassumi xejn. Ittestja b’talba minima:

vibe "Say hello"

Jekk iċ-ċavetta tkun valida, Vibe jwieġeb normalment. Jekk tkun invalida jew skadiet, se tikseb żball ta’ awtentikazzjoni ċar, li jiffrankalek milli tfittex il-kawża fl-installazzjoni.

Jekk tikkonfigura fornituri addizzjonali bħal OpenRouter, kull wieħed jeħtieġ il-varjabbli tiegħu stess. It-tnejn jikkoegżistu mingħajr problemi:

export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"

Se nkopru l-konfigurazzjoni tal-fornituri ta’ partijiet terzi fid-dettal fil-lezzjoni ddedikata.

Punti Ewlenin

  • Ikseb iċ-ċavetta tal-API ta’ Mistral tiegħek fuq console.mistral.ai
  • Tliet metodi ta’ konfigurazzjoni: setup interattiv, varjabbli tal-ambjent, config.toml
  • Il-varjabbli tal-ambjent tieħu prijorità fuq il-fajl .env
  • Qatt ma tagħmel commit taċ-ċavetta tiegħek fuq Git
  • Stabbilixxi limiti ta’ nfiq fuq il-Konsoll ta’ Mistral