AI temsilcilerini doküman sitelerine bağlayın
Claude Code, Codex, ChatGPT veya kendi betiklerinizin doküman sitesi sayfalarını taslak olarak hazırlamasına, düzenlemesine ve yayınlamasına izin verin. Planlar (Pro ve üzeri), doküman sitesi izinleri, site kapsamı ve yayınlama kuralları ile tam AI temsilcileri ve API rehberlerine bağlantılar.
Claude Code, Codex, Cursor, Claude veya ChatGPT gibi AI temsilcileri, doküman sitelerinizi sizin yerinize okuyabilir ve yazabilir: makale taslakları oluşturabilir, okuyucuların düşük puan verdiği sayfaları düzeltebilir, içerik boşluklarını yanıtlayabilir, çeviri yapabilir veya yayınlayabilir. Bu makale, doküman sitelerine özgü konuları ele almaktadır. Tokenlar, bağlayıcılar, harcamalar ve hatalar AI temsilcileri ve API bölümünde açıklanmıştır.
Başlamadan önce
- AI temsilcileri ve API; Claude ve ChatGPT bağlayıcıları dahil olmak üzere Pro, İş ve Özel planlarda mevcuttur. Ücretsiz ve Başlangıç planları bunu içermez; bir çalışma alanı bunlardan birine geçerse tokenlar ve uygulamalar çalışmayı durdurur.
- Bir temsilci, token'ını oluşturan veya onu bağlayan kişi gibi, o kişinin rolü dahilinde hareket eder. Bir sitede asla o kişinin yapabileceğinden fazlasını yapamaz.
- API çağrıları kredi harcamaz. Sayfaları çevirmek ve AI ile site sayfaları oluşturmak kredi harcar ve bu sadece kredi harcayabilen bir token ile mümkündür.
Bir temsilci bağlayın
Çalışma alanı menüsünü açın ve AI temsilcileri ve API'yi seçin ya da bir doküman sitesinin Ayarlar menüsünden AI temsilcileri ve API'yi seçin (bu, o site için etkinliği açar).
- Claude Code, Codex, Cursor veya bir betik için API token'ı: Tokenlar → Yeni token, ardından dört adımlı bir sihirbaz (Amaç, İzinler, Sınırlar, İncele). Yazar veya Yayıncı gibi bir doküman sitesi ön ayarı seçin, Sınırlar → Doküman siteleri altından siteleri belirleyin ve yalnızca bir kez gösterilen token'ı kopyalayın. Bkz. API token'ı oluşturma.
- Claude.ai veya ChatGPT için Bağlayıcı: Bağlı uygulamalar bölümündeki Bağlayıcı URL'sini uygulamaya yapıştırın, oturum açın ve Siteler ile Erişim seçeneklerini belirleyin. Bkz. AI uygulamalarını ve temsilcilerini bağlama.
Doküman sitesi ön ayarları
| Ön ayar | Ekrandaki açıklama | Kullanım amacı |
|---|---|---|
| Yazar | "Temsilciler taslak hazırlar; bir kişi inceler ve yayınlar." | Makale ve değişiklik günlüğü girdileri taslağı oluşturma, görsel yükleme |
| Yayıncı | "Okuyucuların gördüklerini değiştirebilen güvenilir otomasyon." | Yayınlama, ayarlar ve site oluşturma dahil doküman siteleri için her şey |
| Destek asistanı | "Yayınlanmış dokümanlardan yanıtlar. Başka hiçbir şey değil." | Yalnızca yayınlanmış, herkese açık sayfaları arayan bir yardım botu |
| Salt okunur | "Araştırma, denetimler ve çeviri kontrolleri." | İçerik okuma |
| Analist | "Düzeltmeler önermek için içeriği ve okuyucu sinyallerini okur." | İçerik ve içgörüleri okuma |
Yapımcı ve Çalışma alanı temsilcisi video ekler ve kredi harcar. Her izin ve bunu kimin verebileceği: Temsilci izinleri.
Doküman sitesi izinleri
| İzin | İzin verilenler |
|---|---|
content:read |
Siteleri, sayfaları, makaleleri (taslaklar dahil), revizyonları, değişiklik günlüğünü ve site sayfalarını okuma |
articles:write |
Makale taslakları oluşturma ve yayında olmayan makaleleri düzenleme |
structure:write |
Bölümler oluşturma ve düzenleme; sayfaları taşıma, gizleme ve yeniden adlandırma |
site-pages:write |
Ana sayfa, iletişim ve yasal sayfalar gibi site sayfalarını düzenleme |
changelog:write |
Değişiklik günlüğü girdilerini taslak olarak oluşturma ve düzenleme |
media:write |
Görsel yükleme |
site:publish |
Yayınlama: okuyucuların gördüklerini değiştirme, canlı içeriği düzenleme, sayfaları hazır olarak işaretleme |
insights:read |
Arama boşluklarını, yanıtlanmamış soruları ve sayfa geri bildirimlerini okuma |
site:configure |
Site ayarlarını, görünümü ve gezinmeyi değiştirme |
sites:create |
Yeni doküman siteleri oluşturma |
help:read |
Yalnızca yayınlanmış, herkese açık sayfaları arama (destek asistanı için) |
Okuma, tüm üyelere açıktır. Yazma ve düzenleme: sahip, yöneticiler, editörler ve İçerik Oluşturucular. Yayınlama ve site ayarları: sahip, yöneticiler ve editörler ("Yalnızca sahipler, yöneticiler ve editörler yayınlama yetkisi verebilir."). Site oluşturma: sahip ve yöneticiler.
Bir token'ın kapsadığı siteler
Sınırlar → Doküman siteleri altında Tüm siteler ("Yeni siteler dahil bu çalışma alanındaki her doküman sitesi.") veya Seçilen siteler seçeneğini belirleyin. Bir token veya bağlı uygulama yalnızca kapsadığı siteleri görür ve değiştirir. Bir makale kapsam dışındaki bir sitede de görünüyorsa, değişiklik reddedilir: "Bu makale, bu token'ın değiştiremeyeceği bir sitede de gösteriliyor."
Canlı içerik yayınlama hakları gerektirir
site:publish olmadan, bir temsilci okuyucuların gördüklerini değiştiremez. Yayında olan bir makaleyi düzenleme reddedilir ("Bu içerik yayınlanmış bir sitede canlıdır, bu yüzden değiştirmek site:yayınla yeteneğini gerektirir.") ve temsilci bunun yerine taslağını inceleme için gönderebilir. Şu bildirimi alırsınız: "temsilci, site üzerindeki sayfa için inceleme istedi": "Hiçbir şey yayınlanmadı. Makaleyi okuyun ve hazır olduğunda yayınlayın."
Bir temsilcinin yaptığı her değişiklik, sayfa geçmişinde "Temsilci ad (token)" olarak görünür. Yayınlamalar, token başına saatte 10 ile sınırlıdır. Duraklatılmış bir site, temsilciler için salt okunurdur: "Bu site duraklatılmış veya çevrimdışı ve salt okunurdur."
Temsilciler bir sitede neler yapabilir
Siteleri listeleme ve sayfa ağacını okuma, sayfaları arama ve okuma, Markdown önizleme, makale oluşturma ve güncelleme, inceleme için gönderme, bölümleri ve sayfaları düzenleme, site sayfalarını ve değişiklik günlüğünü düzenleme, görsel yükleme, içgörüleri okuma ve boşlukları giderilmiş olarak işaretleme, ayarları, görünümü, gezinmeyi ve yönlendirmeleri değiştirme, site oluşturma, sayfaları çevirme, site sayfaları oluşturma, yayınlama ve geri alma. Her biri ilgili izni gerektirir.