Ajana görev verme
Ajan, paneldeki Ajan sekmesinden konuşarak çalışır — komut sözdizimi yoktur. İstediğinizi Türkçe (veya başka bir dilde) söylersiniz; ajan bir plan kurar, gereken araçları çağırır ve riskli adımlarda onay ister.
Basit bir görev
Bu ayki en çok soru alan 5 konuyu bilgi tabanından çıkar,
kısa bir özet hazırla.Ajan kb_search ve data_aggregate gibi T1 araçları kullanır; hepsi yan-etkisiz olduğundan onay gerekmez, sonuç doğrudan sohbete gelir.
Çok-adımlı görevler
Ajan büyük işleri kendisi adımlara böler. Örneğin:
Geçen haftaki siparişlerden iade taleplerini bul,
her biri için müşteriye kısa bir dönüş taslağı yaz,
hepsini bir tabloda özetle.- Her adımın sonucu bir sonrakine bağlam olur; adımlar bağımsızsa paralel ilerler.
- Uzun işlerde ara-durum mesajları gelir ("3/5 tamamlandı").
- Kesinti olursa görev kaldığı yerden devam eder (resume).
Artefaktlar
Ajan doküman/sunum/tablo/görsel üretebilir (doc_generate, xlsx_generate, …). Üretilen dosyalar görevin artefaktları olarak iner; list_artifacts ile listelenir ve indirilebilir. İsterseniz sohbetten indirmekle kalmayıp doğrudan Google Drive'a kaydettirebilirsiniz.
Aksiyonları onaylama
Bir görev dış dünyada değişiklik gerektirdiğinde (e-posta gönder, takvim oluştur, mağazayı güncelle) ajan bir onay kartı gösterir. Onaya kadar o adım beklerken bağımsız adımlar durmaz. Ayrıntı: Otonomi & onaylar.
Mail eklerini Google Drive'a arşivleme
Ajan, gelen e-postalardaki ekleri (fatura, sözleşme, ekstre…) alıp Google Drive'da düzenli klasörlere arşivleyebilir. Tipik istek:
[email protected] adresinden 2026 içinde gelen maillerdeki
fatura eklerini Google Drive'da SemAgent > Faturalar > Tedarikçi altına koy- Ön koşul: Ajan Connector'larında Gmail (IMAP) ve Google Drive bağlı olmalı.
- Ajan önce mailleri arar (
gmail_search), sonra ekleri güvenli karantinaya alır (gmail_attachments) — ek içeriği (PDF byte'ları) modele hiç girmez. - Ardından dosyaları Drive'a yükler (
drive_upload). Klasör yoksa oluşturulur; iç içe yol verebilirsiniz (ör.Faturalar/<Firma>/<Yıl-Ay>). - Yükleme onay gerektirir; ajan aynı turdaki tüm yüklemeleri TEK onay kartında toplar — 7 dosya için 7 kez değil, bir kez onaylarsınız.
İçeriği sorabilirsiniz. "2026'da toplam ne kadar fatura ödemişim?" gibi sorularda ajan tutarı üç kaynaktan okuyabilir: (a) mail gövdesi — sadece HTML olan bildirim/fatura maillerinde de metne çevrilir, (b) ekin içi — gmail_attachments extract_text=true ile PDF/Word/Excel/CSV okur (taranmış PDF'te OCR), (c) Drive'daki arşiv — drive_read yüklenmiş PDF'in metnini çıkarır. Dış içerik olduğu için hepsi güvenlik karantinasından geçer.
Bunu her ay kendiliğinden çalıştırmak isterseniz aynı isteği zamanlanmış + otonom göreve çevirin (aşağıdaki bölüm): "…her ayın 27'sinde bunu yap ve bana özet tablo at".
Tablo/sunum üret → Drive'a kaydet
Ajanın ürettiği dosya artık sohbette kalmak zorunda değil: ürettiği Excel/Word/sunumu doğrudan Google Drive'a koyabilir. Tipik istekler:
abc firmasından gelen mailleri kontrol et, 2026'da ödediğim
fatura toplamı nedir — Drive'da xyz klasörüne Excel tablosu olarak kaydet
Drive'daki xyz klasöründeki dosyaları oku, bunlardan bir sunum
hazırla ve aynı klasöre koy- Ön koşul: Ajan Connector'larında kaynağa göre Gmail (IMAP) / Google Drive, yazma için de Google Drive Yükleme (drive.file) bağlı olmalı.
- Ajan önce veriyi toplar (
gmail_search+gmail_attachments, ya dadrive_read), hesaplar (data_aggregate). - Dosyayı üretir —
xlsx_generate,doc_generateya dapptx_generate. Bu adım yan etkisizdir, onay istemez. - Üretilen dosyayı Drive'a yükler (
drive_upload,artifactkaynağı). Bu adım onaya düşer; aynı turdaki tüm yüklemeler tek onay kartında toplanır.
"O klasörü bulamıyorum" diyorsa sebebi budur. Tek tıkla kurulan Drive bağlantısı Google'ın drive.file kapsamıyla çalışır: ajan yalnız kendi oluşturduğu dosya ve klasörleri görür. Sizin elle açtığınız bir klasör onun için görünmezdir. Çözüm: hedef klasör ağacını ajana kurdurun ("Drive'da SemAgent > Raporlar klasörünü oluştur, bundan sonra hep oraya koy") ve o ağacı kullanın; ya da Kasa'ya tam drive kapsamlı bir Google kimliği koyun.
Klasörü adıyla söylemeniz yeterlidir; klasör yoksa oluşturulur ve iç içe yol verebilirsiniz (ör. Raporlar/2026/Temmuz). Dosya adını siz belirtmezseniz ajan içeriğe uygun bir ad üretir.
Otonom görevler (onay beklemeden)
Bir görevi sohbetten otonom kurabilirsiniz: görev her çalıştığında sınırlı (bounded) bir araç seti — mail oku · ek indir · Drive'a koy · rapor üret · mail gönder — onay beklemeden çalışır; bunun dışındaki her aksiyon (silme, iletme, sosyal yayın, SMS…) yine onaya düşer. Güvenlik: e-posta yalnız hesap sahibine ve talimatta adını verdiğiniz sabit alıcılara gider — mail içeriğinden türeyen bir adrese asla. Gönderen/klasör/rapor-alıcısı gibi parametreler sizin talimatınızdan gelir; mail içeriği bunları değiştiremez. Zamanlama ayrıntıları: Zamanlama & brifing.
İyi görev yazmanın ipuçları
- Sonucu söyleyin, adımları değil: "…için bir rapor hazırla" > "önce şunu, sonra bunu yap". Ajan planı kurar.
- Bağlam verin: hangi kaynak, hangi tarih aralığı, kime.
- Kısıtları belirtin: "yalnızca taslak hazırla, gönderme" gibi.
- Tekrar eden işleri zamanlayın; sık düzelttiğiniz şeyler kurala döner.
SemAgent