Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon Kā es varu pievienot pielāgotus rīkus vai pagarinājumus Gemini CLI


Kā es varu pievienot pielāgotus rīkus vai pagarinājumus Gemini CLI


Lai pievienotu pielāgotus rīkus vai paplašinājumus Dvīņu CLI, primārais mehānisms ir caur modeļa konteksta protokolu (MCP) un pielāgotajiem paplašinājumiem, kurus atbalsta Gemini CLI. Zemāk ir detalizēts rokasgrāmata ar galvenajiem aspektiem un soļiem, lai pievienotu pielāgotus rīkus vai paplašinājumus Gemini CLI:

GEMINI CLI paplašināšana ar pielāgotiem rīkiem, izmantojot MCP

Dvīņi CLI ir veidots tā, lai būtu paplašināms, izmantojot modeļa konteksta protokolu (MCP). MCP darbojas kā standartizēts veids, kā savienot ārējos pakalpojumus un iespējas (rīkus) ar Gemini CLI. Konfigurējot MCP serverus, Gemini CLI var nemanāmi integrēt šos ārējos rīkus savā AI vadītajā komandā un argumentācijas darbplūsmā.

- MCP serveru iestatīšana:
Jūs sākat, konfigurējot MCP serverus Gemini CLI iestatījumu failā, kas parasti atrodams vietnē `~/.gemini/iestatījumi.json`. Šis JSON fails konfigurē ar to, ar kuriem MCP serveri izveidot savienojumu, ieskaitot savienojuma informāciju un autentifikāciju, ja nepieciešams.

- Esošo vai pielāgoto MCP serveru izmantošana:
Daudzi esošie MCP serveri saskarnē ar populāriem pakalpojumiem, piemēram, Github, GitLab, Firebase, datu bāzēm vai multivides ģenerēšanu. Lai iegūtu patiesi pielāgotu funkcionalitāti, varat izveidot savus MCP serverus, izmantojot MCP SDK, kas pieejams tādās valodās kā Python vai TypeScript. Tas ļauj mitināt jebkuru pielāgotu loģiku vai rīku kā MCP serveri.

- MCP serveru konfigurēšana:
Failā “Settings.json` MCP serveri tiek definēti ar to nosaukumiem, servera tipiem, savienojuma komandām vai URL, žetoniem autentifikācijai un visiem specializētiem parametriem. Pēc konfigurēšanas Gemini CLI izveidos savienojumu ar šiem serveriem startēšanas laikā.

- Rīku atklāšana un izmantošana:
Pēc savienojuma MCP serveri atklāj rīkus, kurus Dvīņi CLI automātiski atklāj. Jūs varat uzskaitīt un aprakstīt šos rīkus ar tādām komandām kā `/MCP` un`/MCP Desc`. Pēc tam AI aģents tos dabiski integrē lēmumu pieņemšanas un izpildes plūsmā, izvēloties rīkus pēc nepieciešamības, pamatojoties uz lietotāju uzvednēm bez manuālas iejaukšanās.

DEVINI CLI paplašinājumu izveidošana

Papildus MCP serveriem Gemini CLI atbalsta augstāka līmeņa koncepciju ar nosaukumu Extensions, kas apvieno MCP serverus, konteksta failus un pielāgotas komandas, lai paplašinātu Gemini CLI funkcionalitāti.

- Pagarinājuma atrašanās vieta:
Pagarinājumi var atrasties divās primārajās vietās: `/.gemini/paplašinājumi/` vai `/.gemini/extensions/`. Dvīņi CLI ielādē visus paplašinājumus, kas atrodami abās vietās startēšanas laikā, un darbvietai raksturīgi paplašinājumi, kas pārsniedz mājas direktoriju versijas, ja rodas konflikti.

- pagarinājuma struktūra:
Katrs paplašinājums ir direktorijs, kas nosaukts pēc paplašinājuma (piemēram, “My-Extension`), kurā ir konfigurācijas fails ar nosaukumu` gemini-extension.json`. Šis JSON ietver metadatu un servera konfigurācijas.

- gemini-estension.json saturs:
Tipiskas atslēgas šajā failā ietver:

- `Name`: unikāls paplašinājuma nosaukums.
- `Versija`: paplašinājuma versija.
- `McPServers`: MCP serveru karte, ko konfigurē paplašinājums, piemēram, komandas, lai palaistu pielāgotus MCP serverus.
- "ContextFilename": izvēles. Konteksta faila nosaukums, kas ielādēts kā darba vietas konteksts paplašinājumam, noklusējumi ir `gemini.md`.
- `Excludetools`: masīvs, kas norāda rīkus vai rīka komandas, lai izslēgtu, kas ir noderīga bīstamu vai nevēlamu operāciju bloķēšanai.

- pielāgotas komandas paplašinājumos:
Paplašinājumi var nodrošināt pielāgotas slīpsvītras komandas, ievietojot `.toml komandas definīcijas failus komandu/` apakšdirektorijā paplašināšanas direktorijā. Šīs komandas tiek definētas līdzīgi kā lietotājam vai projektam specifiskas komandas.

- Apvienot uzvedību:
Kad sākas Dvīņi CLI, tas apvieno paplašināšanas konfigurācijas ar lietotāja galvenajiem iestatījumiem un iebūvētajiem rīkiem, risinot konfliktus, piešķirot darba vietas iestatījumus prioritāti.

Izveidot pielāgotas slīpsvītras komandas ar Tomla failiem

Elastīgs veids, kā pievienot atkārtoti lietojamas komandas (rīkus), ir, izmantojot “.toml” failus kā pielāgotas slīpsvītras komandas.

- Atrašanās vieta:
Ievietojiet Toml komandu failus `~/.gemini/commans/` globālām komandām vai projekta vietējā `.gemini/komandām/` direktorijā.

- Tomla formāts:
Šie faili definē komandu, uzvednes veidnes un var iekļaut argumentus ar vietniekiem, piemēram, ``. Viņi arī atbalsta čaulas komandu izpildi uzvednē, izmantojot sintakse, piemēram, `! {...}`, lai iegultu skriptu veidošanu.

- Lietošana:
Šīs komandas var izsaukt tieši Dvīņu CLI, izmantojot tādas slīpsvītru komandas kā `/Mycommand`, viegli ļaujot skriptētām darbplūsmām vai integrācijām.

Pielāgotu python skriptu un čaulas komandu palaišana

- Tā kā Gemini CLI atbalsta apvalka komandu un skriptu palaišanu, jūs varat aktivizēt pielāgotus Python skriptus vai citas programmas kā daļu no sava MCP servera vai pielāgotas komandu darbplūsmas.

- Piemēram, Python skriptu, kas ģenerē PDF no Gemini CLI atbildēm, varētu ietīt MCP serverī vai izpildīt kā apvalka komandu pielāgotā Tomla komandā, ļaujot vienas komisijas ģenerēšanas darbplūsmas.

integrācija ar IDE un vidi

- Dvīņu CLI paplašinājumi var arī uzlabot integrāciju ar IDE, piemēram, VS kodu, koplietojot darbvietas kontekstu (faili, kursora atrašanās vieta, atlase), ļaujot AI balstītai koda palīdzības darbplūsmai.

- Paplašinājumi un MCP serveri palīdz integrēt pielāgotas darbplūsmas tieši CLI vai IDE vidē, uzlabojot produktivitāti un rīku ķēdes elastību.

Procesa kopsavilkums, lai pievienotu pielāgotus rīkus vai paplašinājumus

1. Izlemiet pielāgotā rīka jomu:
Nosakiet, vai tā ir vienkārša pielāgota komanda, skripts vai pilnībā izveicīgs ārējs pakalpojums.

2. Par vienkāršām pielāgotajām komandām:
Izveidojiet `.toml` failus, kas definē slīpsvītras komandas, un ievietojiet tos attiecīgajā komandu mapē.

3. Ārējiem pakalpojumiem vai sarežģītai loģikai:
Izstrādājiet MCP serveri, izmantojot MCP SDK (atbalstot tādas valodas kā Python vai TypeScript), kas pakļauj rīka iespējas, izmantojot standartizētu API.

4. Konfigurējiet MCP serveri iestatījumos.json` vai paplašinājums:
Pievienojiet MCP servera konfigurācijas ierakstu (ar komandu vai URL) tieši lietotāja konfigurācijā `~/.gemini/setting.json` vai iekšpusē` gemini-extension.json` failā paplašinājuma direktorijā.

5. pēc izvēles saišķa pagarinājumā:
Iepakojiet savus MCP serverus, pielāgotās komandas un konteksta failus paplašināšanas direktorijas struktūrā saskaņā ar `.gemini/paplašinājumiem/`.

6. Sāciet vai restartējiet Gemini CLI:
Dvīņi CLI ielādē visas konfigurācijas un MCP serverus startēšanas laikā, automātiski integrējoši pielāgoti rīki.

7. Izmantojiet un pārbaudiet rīkus:
Izmantojiet tādas komandas kā `/MCP` un`/MCP Desc`, lai apstiprinātu rīka pieejamību un mijiedarbotos ar jūsu pielāgotajiem papildinājumiem.

Šīs arhitektūras priekšrocības

- Modularitāte: rīki darbojas kā atsevišķi MCP serveri, padarot attīstību neatkarīgu un mērogojamu.

- Dinamiskā integrācija: Rīki automātiski parādās Dvīņu CLI darbplūsmās bez hardkodēšanas.

- Drošība un vadība: paplašinājumi var ierobežot, kuri rīki vai apvalka komandas ir atļautas, novēršot nepareizu izmantošanu.

- atkārtota izmantojamība: Pagarinājumu pakete Pilnīgas darbplūsmas, koplietojamas starp projektiem vai komandām.

- Sabiedrība un ekosistēma: ir pieejami daudzi MCP serveri un paplašinājumi, vai tos var dot, strauji paplašinošas DVIini CLI iespējas.

Šī arhitektūra ļauj praktiski jebkuru ārēju rīku, skriptu vai pakalpojumu integrēt Gemini CLI ekosistēmā, palielinot produktivitāti un pielāgošanu.

***

Šī atbilde sniedz rūpīgu Dvīņu CLI pielāgotā rīka un paplašināšanas integrācijas mehānismu skaidrojumu, ieskaitot MCP serverus, paplašinājuma iesaiņojumu, pielāgotās komandas un skriptu integrāciju, atbilstošo garumu un detaļu izpildi. Ja vēlaties, nākamo var sniegt vairāk specifiku par MCP SDK lietošanu vai konfigurāciju piemēru.

Visas informācijas pamatā ir autoritatīva Gemini CLI dokumentācija un kopienas avoti, kas pieejami no 2025. gada septembra.