Dokümantasyon / Entegrasyonlar

Google Workspace

Bir kez izin verdikten sonra Secretary takviminizi, Gmail gelen kutunuzu, Drive'ınızı ve Google Sheets'inizi okuyabilir. Yalnızca siz yazmayı açarsanız ve her çağrıyı onaylarsanız yazar; hiçbir zaman e-posta göndermez.

Secretary

Secretary, secretary preset'idir. google.read ve google.write yetkilerine sahiptir ve google skill'inin sahibidir. Ekipte yalnızca IVRALO_GOOGLE_SERVICES'te en az bir servis tanımlıysa yer alır.

Ana ajan hiçbir hesabı kendisi okumaz. Takvim, gelen kutusu, Drive ve Sheets soruları Secretary'ye gider; Secretary'nin getirdikleri de işin geri kalanı hangi uzmanın alanındaysa ona aktarılır.

Kurulum

Bir Google hesabına ve Google Cloud Console'da ivralo için oluşturulmuş bir OAuth istemcisine ihtiyacınız var. Google bir programa kimliği bu yolla verir; bunu bir kez yaparsınız.

console.cloud.google.com adresini açın ve bir proje oluşturun.
APIs & Services, Library altından ihtiyacınız olan API'leri etkinleştirin: Google Sheets API, Google Drive API, Google Calendar API, Gmail API.
OAuth consent screen altında External'ı seçin, bir ad verin ve kendi hesabınızı test kullanıcısı olarak ekleyin. Tek kişilik kullanım için uygulama test modunda kalabilir.
Credentials altında Desktop app türünde bir OAuth client ID oluşturun. Google size bir client ID ve bir client secret verir.

Bunları, bağlanacak servislerle birlikte ana dizininizdeki .env'ye ekleyin:

GOOGLE_CLIENT_ID=123456789-example.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-change-me
IVRALO_GOOGLE_SERVICES=sheets,drive,calendar,gmail

google-workspace extra'sını kurun (ilk satır checkout'tan kurulum içindir), ardından izin verin:
```
uv sync --extra google-workspace
ivralo google login
```

Tarayıcıda bir sayfa açılır. Test kullanıcısı olarak eklediğiniz hesapla giriş yapın ve listelenen erişimlere izin verin. Token ana dizine google-token.json olarak kaydedilir ve bundan sonra kendiliğinden yenilenir. Bir sonraki oturumdan itibaren Secretary ekiptedir.

İzin bir kez, oturumun dışında verilir

Oturum hiçbir zaman tarayıcı açmaz. İzin yalnızca sizin kendi çalıştırdığınız ivralo google login ile verilir. Kullanılabilir bir token yoksa Secretary'nin tek bir aracı olur; o araç da yeniden denemek yerine size hangi komutu çalıştırmanız gerektiğini söyler.

Komut	Ne yapar
`ivralo google login`	izin için tarayıcıyı açar; `--yes` açmadan önceki soruyu atlar
`ivralo google status`	neyin hazır olduğunu gösterir ve önce neyin düzeltilmesi gerektiğini söyler
`ivralo google logout`	token'ı siler

ivralo doctor'da da bir google bölümü vardır. Token'ı Google hesabınızın güvenlik sayfasından istediğiniz zaman iptal edebilirsiniz.

Neleri okur

Sorduğunuz	Çağırdığı araçlar
perşembe takvimde ne var	`list_events`, `search_events`, `find_available_slots`
sözleşme gönderilmiş mi	`search_emails`, `get_emails_from_user`, `get_thread`
eki çalışma alanına almak	`download_attachment`, çalışma alanındaki `inbox/`'a
Drive'daki bir dosya	`search_files`, `read_file`, `download_file`
bir Google Sheet'teki sayılar	`read_sheet`

Her iddia kaynağıyla birlikte gelir: etkinliğin başlığı ve saati, e-postanın göndereni, tarihi ve konusu, dosyanın adı ve kimliği. İndirilen dosya da diğerleri gibi bir çalışma alanı dosyasıdır; indekslenebilir ya da üzerinde hesap yapılabilir.

Kapsamlar

ivralo varsayılan olarak Google'dan, tanımladığınız her servis için yalnızca salt okuma kapsamını ister. Yazmayı açınca yazma kapsamları da eklenir; bu yüzden ardından ivralo google login'i yeniden çalıştırın.

Servis	Okuma kapsamı	Yazma açıkken eklenen
`sheets`	`spreadsheets.readonly`	`spreadsheets`
`drive`	`drive.readonly`	`drive.file`
`calendar`	`calendar.readonly`	`calendar`
`gmail`	`gmail.readonly`	`gmail.compose`, `gmail.modify`

Yazar ama göndermez

IVRALO_GOOGLE_WRITE=true şunları açar: sheet ve etkinlik oluşturma ve güncelleme, Drive'a yükleme, e-posta taslağı yazma, e-postaları işaretleme ya da etiketleme. Bunların her biri yüksek riskli bir çağrı olarak onayınızı bekler ve başında kimsenin olmadığı çalıştırmalarda hiçbiri bulunmaz.

Ayarlar

Değişken	Varsayılan	Neyi belirler
`GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`	tanımsız	Cloud Console'daki OAuth istemcisi
`IVRALO_GOOGLE_SERVICES`	tanımsız	`sheets`, `drive`, `calendar`, `gmail` değerlerinden istedikleriniz; tanımlı değilse Secretary ekipte olmaz
`IVRALO_GOOGLE_WRITE`	`false`	her biri ayrıca onay isteyen yazma araçları
`IVRALO_GOOGLE_TOKEN`	ana dizinde `google-token.json`	token'ın saklandığı yer