Verimlilik & belgeler
Notion'ı Otonom Bir Yapay Zeka Ajanına Bağlamak
Notion'a bağlı bir Atako ajanı sayfalarınızı ve bazlarınızı okuyabilir, yenilerini oluşturabilir veya değiştirebilir, ama yalnızca kendisiyle açıkça paylaştıklarınızı.
Olası iş akışları
Bir takip bazının haftalık güncellenmesi
Ajan, bir Notion bazını (projeler, adaylar, müşteri hesapları) query_database ile sorgular, e-posta veya başka bir konektörden alınan verilerle çapraz kontrol eder, yeni girdileri create_page ile oluşturur ve mevcut girdileri update_page ile günceller. Bazın formatı ve özellikleri ekibinizin tanımladığı gibi kalır; ajan yalnızca bazı bir insanın her pazartesi sabahı yapacağından daha hızlı doldurur.
Yapılandırılmış toplantı tutanakları
Başka bir kanaldan alınan bir toplantı özetinden yola çıkarak, ajan doğru klasörde bir sayfa oluşturur (create_page), ardından onu bağlam paragraflarıyla (append_paragraph), bir kararlar listesiyle (append_bulleted_list) ve her katılımcı için işaretlenebilir bir görev listesiyle (append_to_do) yapılandırır. Dikkat noktaları, yeniden okurken göze çarpması için bir callout ile öne çıkarılır.
Bir bilgi tabanının periyodik arşivlenmesi
Ajan, son değişiklik tarihine göre filtrelenmiş bir bazı sorgular (query_database), aylardır hareket etmeyen sayfaları tespit eder, arşivlenme önerisinin nedenini açıklayan bir yorum bırakır (create_comment), ardından bunları arşivler (archive_page). Hiçbir şey kaybolmaz: arşivlenmiş bir sayfa görülebilir kalır ve gerekirse elle geri getirilebilir; bu da kimsenin artık danışmadığı güncelliğini yitirmiş içeriklerle aşırı yüklenmiş bazların birikmesini önler.
Bağlayıcı eylemleri
query_database (okuma)
Filtreler ve sıralamalarla bir bazı sorgular.
search (okuma)
Paylaşılan sayfaları veya bazları başlığa göre arar.
get_page (okuma)
Bir sayfayı ve özelliklerini alır.
get_database (okuma)
Bir bazın şemasını alır.
list_block_children (okuma)
Bir sayfanın ayrıntılı içeriğini okur.
create_page (yazma)
Bir bazda veya bir üst sayfanın altında bir sayfa oluşturur.
update_page (yazma)
Bir sayfanın özelliklerini günceller.
append_paragraph (yazma)
Bir sayfaya bir metin paragrafı ekler.
append_to_do (yazma)
Bir sayfaya işaretlenebilir kutular ekler.
create_comment (yazma)
Bir yorum ekler veya mevcut bir file yanıt verir.
archive_page (yazma)
Bir sayfayı, geri döndürülebilir şekilde çöpe arşivler.
Ön koşullar
- notion.so/my-integrations üzerinde, tek bir workspace'e bağlı dahili bir entegrasyon oluşturmak.
- Read content, Update content, Insert content özelliklerini, artı yorumları etkinleştirmek.
- Yalnızca bir kez gösterilen entegrasyon sırrını (ntn_ veya secret_ ön eki) kopyalamak.
- Her sayfayı veya bazı ••• ardından Connections üzerinden entegrasyonla paylaşmak.
- Atako'da, ajana grant'i vermek için entegrasyon yönetimi hakkı.
Nasıl bağlanılır
- 1
Notion entegrasyonunu oluşturun
notion.so/my-integrations üzerinde, bir entegrasyon oluşturun, workspace'i seçin, özellikleri etkinleştirin, sırrı kopyalayın.
- 2
Sayfaları entegrasyonla paylaşın
Ajana verilecek her sayfayı veya bazı açın, ••• ardından Connections'a tıklayın, entegrasyonu seçin. Bu adım olmadan, token tek başına hiçbir şeye erişim vermez.
- 3
Notion'ı Atako'ya bağlayın
Ayarlar, ardından Entegrasyonlar'ta, 1. adımda kopyalanan sırrı yapıştırın.
- 4
Ajana grant'i verin
Ajanın sayfasından (Bu ajanın entegrasyonları) veya bağlantıdan (Erişimi yönet), izin verilecek kesin eylemleri ve kapsamlarını (salt okunur veya okuma ve yazma) seçin.
Neden otonom bir ajanı Notion'a bağlamalı
Notion, bir ekibin bildiğini düzenlediği yer olmaya sıklıkla adaydır: takip bazları, iç dokümantasyon, tutanaklar. Sorun şu ki bu bilgi, kimse güncellemezse hızla eskir. Notion'a tool calling üzerinden bağlı bir Atako ajanı bu işi, bir insanın bazı her hafta açmasına gerek kalmadan, kendi ortamında sürekli olarak yapabilir.
Klasik bir tetikleyici otomasyonuna göre değişen şu: ajan sürekli çalışır. E-posta ile bir bilgi alabilir, query_database üzerinden bir Notion bazında zaten var olanla karşılaştırabilir, ardından kendisine verilen eylemlerin çerçevesinde, bir sayfa oluşturmak mı yoksa mevcut bir girdiyi güncellemek mi gerektiğine tek başına karar verebilir.
Notion konektörü, Atako belgelerine göre 28 eylemi kapsar (13 okuma, 15 yazma), sayfa aramadan özellik şemasıyla baz oluşturmaya kadar. Bu, tutanakların düzenlenmesi kadar bir bilgi tabanının yeniden okunmasını da kapsayacak kadar geniş. Tipik bir kullanım: bir sürüm etrafında iletişimi yöneten bir ajan, diğer kanallarıyla paralel olarak Notion dokümantasyonunu güncel tutar.
Limitler ve iyi uygulamalar
Notion, sayfa sayfa veya baz baz açık bir paylaşım dayatır. Başta bir kısıtlama gibi görünse de aynı zamanda bir güvence: sızabilecek bir token, yalnızca paylaşılmış olana erişim verir, asla tüm workspace'e değil.
Notion API'sinin hızı mütevazı kalır: entegrasyon başına ortalama saniyede üç istek, plana göre değişen bir workspace tavanıyla. Binlerce sayfalık bir bazda, her şeyi yeniden okuması gereken bir ajan, işi zamana yaymak zorunda kalacaktır.
Konektör kalıcı silmeye izin vermez: archive_page bir sayfayı, kurtarılabilir şekilde çöpe taşır. Her Atako entegrasyonunda olduğu gibi, her eylem açık bir grant'e tabidir (ajan, eylem, kapsam): tek başına bağlantı hiçbir erişim vermez. İzin modeline ve planlara bakın.
İlgili kullanım örnekleri
İlgili entegrasyonlar
Sık sorulan sorular
Ajan Notion workspace'imdeki herhangi bir sayfayı değiştirebilir mi?
Hayır. Ajan yalnızca Connections menüsü üzerinden entegrasyonla açıkça paylaşılan sayfaları ve bazları görür. Paylaşılmış olsa bile, bir sayfa yalnızca ajanın grant'i uygun kapsamda bir yazma eylemi içeriyorsa değiştirilebilir.
API'yi bağlamak için ücretli bir Notion planı gerekir mi?
Hayır, Notion API'si ücretsiz planda da ücretli planlarda da çalışır. Plana göre değişen şey, workspace başına izin verilen istek tavanıdır.
Ajanın Notion erişimi nasıl iptal edilir?
İki tamamlayıcı seçenek: bir sayfanın bağlantılar listesinden entegrasyonu kaldırmak, veya Atako tarafında bağlantıyı iptal etmek. Her iki durumda da erişim, ilgili tüm ajanlar için hemen kesilir.
Ajan bir Notion sayfasını kalıcı olarak silebilir mi?
Hayır. Mevcut tek silme eylemi archive_page'dir, sayfayı yok etmeden çöpe taşır. Bu konektörde kalıcı silme eylemi yoktur.
Sırada ne okumalı
Kaynaklar
- Notion Docs, Create a Notion integration · erişim tarihi 4 Eylül 2026
- Notion Docs, Request limits · erişim tarihi 4 Eylül 2026
Atako CTO'su
Bu içerik Atako'nun yapay zeka ajanları tarafından yazılmış, ardından Atako CTO'su Romain Laodicina tarafından gözden geçirilmiş, düzeltilmiş ve onaylanmıştır.