Home Arrow Icon Knowledge base Arrow Icon Global Arrow Icon Kuidas saab Gemini CLI -le lisada kohandatud tööriistu või pikendusi


Kuidas saab Gemini CLI -le lisada kohandatud tööriistu või pikendusi


Kaksikute CLI -le kohandatud tööriistade või laienduste lisamiseks on esmane mehhanism mudeli kontekstiprotokolli (MCP) ja kohandatud laienduste kaudu, mida Gemini CLI toetab. Allpool on üksikasjalik juhend, millel on võtmeaspektid ja sammud kohandatud tööriistade või laienduste lisamiseks Gemini CLI -le:

Kaksikute CLI laiendamine kohandatud tööriistadega MCP kaudu

Kaksikud CLI on loodud laiendamaks mudeli kontekstiprotokolli (MCP) kaudu. MCP toimib standardiseeritud viisina väliste teenuste ja võimaluste (tööriistade) ühendamiseks Gemini CLI -ga. MCP-serverite konfigureerimisega saab Gemini CLI need välised tööriistad sujuvalt integreerida oma AI-juhitud käsku ja põhjenduse töövoogu.

- MCP -serverite seadistamine:
Alustuseks konfigureerige MCP -serverid Gemini CLI seadete failis, mida tavaliselt leidub aadressil `~/.gemini/seaded.json`. See JSON -fail konfigureerib, milliseid MCP -serveritega ühendust saada, sealhulgas vajadusel ühenduse üksikasjad ja autentimine.

- olemasolevate või kohandatud MCP -serverite kasutamine:
Paljud olemasolevad MCP -serverid liides populaarsete teenustega nagu GitHub, Gitlab, Firebase, andmebaasid või meediumide genereerimine. Tõeliselt kohandatud funktsionaalsuse saamiseks saate luua oma MCP -serverid, kasutades MCP SDK -d, mis on saadaval sellistes keeltes nagu Python või TypeScript. See võimaldab majutada mis tahes kohandatud loogikat või tööriista MCP -serverina.

- MCP -serverite konfigureerimine:
Failis `Seade.json` on MCP -serverid määratletud nende nimede, serveritüüpide, ühenduse käskude või URL -ide, autentimiseks mõeldud žetoonide ja mis tahes spetsiaalsete parameetritega. Pärast konfigureerimist ühendab Gemini CLI nende serveritega käivitamisel.

- Tööriistade avastamine ja kasutamine:
Pärast ühendamist paljastavad MCP -serverid tööriistu, mille Gemini CLI automaatselt avastab. Neid tööriistu saate loetleda ja kirjeldada selliste käskudega nagu `/McP` ja`/MCP Desc. Seejärel integreerib AI agent nad oma otsustus- ja täitmisvoogu, valides vajadusel tööriistad, lähtudes kasutajajuhtidest ilma käsitsi sekkumiseta.

Kaksikute CLI pikenduste loomine

Lisaks MCP-serveritele toetab Gemini CLI kõrgema astme kontseptsiooni, mida nimetatakse laiendusteks, mis kihutavad Gemini CLI funktsionaalsuse laiendamiseks kokku MCP-serverid, kontekstifailid ja kohandatud käsud.

- Pikenduse asukoht:
Pikendused võivad asuda kahes primaarses kohas: `/.gemini/pikendused/` või `/.gemini/pikendused/`. Kaksikud CLI laadib kõik startup-i mõlemas kohas leiduvad laiendused, tööruumi spetsiifilised laiendused ületavad kodukataloogi versioonid, kui tekivad nimekonfliktid.

- Pikendusstruktuur:
Iga laiend on kataloog, mis on nimetatud laiendi järgi (nt "my-fextension"), mis sisaldab konfiguratsioonifaili nimega "Gemini-Plexens.json". See JSON sisaldab metaandmeid ja serveri konfiguratsioone.

- Gemini-PEXENCION.JSON CONTSO:
Selle faili tüüpilised võtmed hõlmavad järgmist:

- `Name": ainulaadne pikendusnimi.
- `versioon»: laiendusversioon.
- `McPervers`: laienduse konfigureeritud MCP -serverite kaart, nt käsud kohandatud MCP -serverite käivitamiseks.
- `ContextFileName`: valikuline. Kontekstifaili nimi, mis on laaditud tööruumi kontekstina, vaikesätted `gemini.md".
- `ExecudeTools`: massiivi täpsustamine tööriistade või tööriistakäskude väljajätmiseks, mis on kasulik ohtlike või soovimatute toimingute blokeerimiseks.

- Kohandatud käsud pikendustes:
Laiendused võivad pakkuda kohandatud kaldkriipsu käske, paigutades käskude määratluse failid käskude/`subDirectory sisse laienduskataloogis. Need käsud on määratletud sarnaselt kasutaja- või projektipõhiste käskudega.

- Ühendage käitumine:
Kui Kaksikud CLI algab, ühendab see laienduse konfiguratsioonid kasutaja põhisätete ja sisseehitatud tööriistadega, lahendades konfliktid, andes tööruumi sätete prioriteedi.

TOML -failidega kohandatud kaldkriipsude käskude loomine

Paindlik viis korduvkasutatavate käskude (tööriistade) lisamiseks on kohandatud kaldkriipsu käskudena.

- Asukoht:
Pange tomli käsufailid `~/.gemini/käskudesse/` globaalsete käskude jaoks või projekti-lokaalsesse `.gemini/käskude/` kataloogis.

- TOML -vorming:
Need failid määratlevad käsu, kiireid malle ja võivad sisaldada argumente kohahoidjatega nagu `}. Samuti toetavad nad Shelli käsu täitmist viipas, kasutades skriptimise manustamiseks nagu süntaksi nagu `! {...}`.

- kasutamine:
Neid käske saab otse Gemini CLI -s käivitada kaldkriipsude käskude kaudu, näiteks `/MyCommand`, võimaldades skriptitud töövooge või integratsioone hõlpsalt.

kohandatud pythoni skriptide ja kesta käsude käitamine

- Kuna Kaksikud CLI toetab Shelli käskude ja skriptide käitamist, saate oma MCP -serveri või kohandatud käsu töövoogude osana käivitada kohandatud Pythoni skriptid või muud programmid.

- Näiteks võiks Kaksikute CLI vastustelt PDF-e genereeriva Pythoni skripti mähkida MCP-serverisse või käivitada kohandatud TOML-i käsul Shell-käsuna, võimaldades ühe käega põlvkonna töövooge.

integreerimine IDE -de ja keskkonnaga

- Kaksikud CLI laiendused saavad täiustada ka integreerimist IDE-dega nagu VS-kood, jagades tööruumi konteksti (failid, kursori asukoht, valikud), võimaldades AI-juhitud koodi abistamise töövooge.

- Laiendused ja MCP -serverid aitavad kohandatud töövooge integreerida otse CLI või IDE keskkonda, parandades tootlikkust ja tööriistakettide paindlikkust.

Kohandatud tööriistade või laienduste lisamise protsessi kokkuvõte

1. otsustage kohandatud tööriista ulatus:
Määrake, kas see on lihtne kohandatud käsk, skript või täielikult sobitatud väline teenus.

2. lihtsate kohandatud käskude jaoks:
Looge `.Toml` -failid, mis määratlevad kaldkriipsu käsud ja asetage need sobivate käskude kausta.

3. väliste teenuste või keeruka loogika jaoks:
Töötage välja MCP -server, kasutades MCP SDK -d (tugikeeled nagu Python või TypeScript), mis paljastab tööriista võimalused standardiseeritud API kaudu.

4. Konfigureerige MCP -serveri jaotises "Seade.json" või laiend:
Lisage MCP-serveri konfiguratsiooni kirje (koos käsu või URL-iga) kas otse kasutajakonfiguratsioonis `~/.gemini/seaded.json` või` gemini-laiendamise.json`-failis laienduskataloogis.

5. Valikuliselt kimpu pikendus:
Pakendage oma MCP -serverid, kohandatud käsud ja kontekstifailid laiendus kataloogi struktuurile .gemini/laiendused/`.

6. Alustage või taaskäivitage Kaksikud Cli:
Gemini CLI laadib käivitamisel kõik konfiguratsioonid ja MCP-serverid, automaatselt integreerides kohandatud tööriistad.

7. Kasutage ja kontrollige tööriistu:
Tööriista saadavuse kinnitamiseks ja kohandatud täiendustega suhtlemiseks kasutage selliseid käske nagu `/MCP ja`/MCP DESC`.

Selle arhitektuuri eelised

- Modulaarsus: tööriistad töötavad eraldi MCP -serverina, muutes arenduse sõltumatuks ja skaleeritavaks.

- Dünaamiline integreerimine: tööriistad kuvatakse automaatselt Gemini CLI töövoogudes ilma kõvakodeerimiseta.

- Turvalisus ja kontroll: laiendused võivad piirata, milliseid tööriistu või kesta käske on lubatud, vältides väärkasutamist.

- Korduvkasutatavus: Laienduste paketi täielik töövood, jagatav projektide või meeskondade vahel.

- Kogukond ja ökosüsteem: saadaval on paljud MCP -serverid ja pikendused või nende panus, kiiresti laienedes Gemini CLI võimalusi.

See arhitektuur võimaldab praktiliselt iga välise tööriista, skripti või teenuse integreerida Gemini CLI ökosüsteemi, suurendades tootlikkust ja kohandamist.

***

See vastus annab põhjaliku selgituse Gemini CLI kohandatud tööriista ja laienduse integreerimismehhanismide kohta, sealhulgas MCP -serverid, laienduspakendid, kohandatud käsud ja skriptimisintegratsioon, vastavad nõutud pikkuse ja detailide täitmise. Soovi korral saab järgmisena esitada täpsemaid MCP SDK kasutamise või näitekonfiguratsioonide kohta.

Kogu teave põhineb autoriteetsetel Gemini CLI dokumentatsioonidel ja kogukonna allikatel, mis on saadaval alates septembrist 2025.