Ce face Autentificarea în agy
Nu există o subcomandă agy login. La pornire, CLI-ul caută un token în keyring-ul sistemului (Apple Keychain, Secret Service pe Linux, Windows Credential Manager); dacă nu găsește, deschide browserul pentru autentificare cu un cont Google personal sau, pentru organizații, Business account → Continue with Google Cloud. Peste SSH, CLI-ul afișează un URL pe care îl deschizi local și îți cere codul primit în browser.
Cu o cheie Gemini API, cererile merg direct la Gemini API, fără sesiune de cont: setezi "modelProvider": "gemini" în settings.json și exporți GEMINI_API_KEY. Doar variabila, fără setare, nu are efect, iar CLI-ul nu citește fișiere .env. GOOGLE_GEMINI_BASE_URL trimite cererile la alt endpoint compatibil. Pentru Google Cloud există și ADC: gcloud auth application-default login, apoi AGY_ADC_AUTH=true.
/logout deconectează contul și șterge tokenii din keyring. Cu autentificare prin cheie API, /logout nu are efect.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
agy |
Autentificare silențioasă din keyring sau prin browser. |
/logout |
Șterge sesiunea și tokenii salvați. |
"modelProvider": "gemini" |
În settings.json: folosește cheia din GEMINI_API_KEY. |
GEMINI_API_KEY |
Cheia Gemini API, creată în Google AI Studio. |
GOOGLE_GEMINI_BASE_URL |
Alt endpoint compatibil Gemini. |
AGY_ADC_AUTH=true |
Folosește Application Default Credentials (opțional GOOGLE_CLOUD_QUOTA_PROJECT, GOOGLE_CLOUD_LOCATION). |
Exemple practice
Exemplul 1: Autentificare cu cheie Gemini API
# în ~/.gemini/antigravity-cli/settings.json: { "modelProvider": "gemini" }
export GEMINI_API_KEY="your-api-key"
agy
Exemplul 2: Application Default Credentials
gcloud auth application-default login --project {GCP_PROJECT}
export AGY_ADC_AUTH=true
agy
Greșeli frecvente și bune practici
- Pui cheia în
GOOGLE_API_KEYsau într-un.env. CLI-ul citește doarGEMINI_API_KEYdin mediu. - Ștergi
GEMINI_API_KEYdar lașimodelProviderpegemini. CLI-ul nu mai pornește; șterge și setarea ca să revii la autentificarea cu cont. - Dictarea vocală eșuează după o autentificare veche. Rulează
/logoutși autentifică-te din nou.