Site araçları
Site araçları, önerilen WebMCP standardının ChatGPT uygulamasıdır. WebMCP sayesinde bir web sitesi, insanların zaten kullandığı arayüzün yanında doğrudan bir AI ajanına faydalı eylemler sunabilir. Siz ve ajan aynı canlı sayfa ve oturum açılmış oturum üzerinde çalışabilirsiniz.
ChatGPT masaüstü uygulamasındaki yerleşik tarayıcıda, ChatGPT Work ve Codex bu araçları kullanılabilir olduklarında keşfedip kullanabilir.
WebMCP ve MCP karşılaştırması
Model Context Protocol (MCP), bir AI uygulamasını yerel veya uzak bir sunucuya bağlar. Araçları, bir hizmette arama yapmak veya kayıtları bir API üzerinden yönetmek gibi işlemleri açık bir web sayfasından bağımsız olarak gerçekleştirebilir.
WebMCP, bir web sitesinin yeteneklerini önceden tanımlanmış bir araç kümesi olarak bir ajana sunmasını sağlar. Ajan bunları siteyi ziyaret ettiğinde keşfedebilir; böylece insanların bu yetenekleri kullanmak için ayrı bir MCP sunucusu kurması veya başka bir bağlantı yapılandırması gerekmez.
Bu yaklaşım, örneğin bir tuvali düzenlerken veya bir panoyu incelerken sizin ve ajanın aynı şeyi görmesi gerektiğinde kullanışlıdır. MCP sunuculu bir eklenti, açık bir sayfadan bağımsız çalışan bir entegrasyon sağlayabilir. Bir web sitesi ikisini de destekleyebilir.
Tarayıcıda nasıl çalışır?
Yerleşik tarayıcıda bir web sitesi açın ve ChatGPT Work ya da Codex'ten bir görev için yardım isteyin. Sayfa site araçları sunuyorsa ajan, görüntülediğiniz web sitesindeki ilgili eylemleri keşfedip kullanabilir. Örneğin bir belge düzenleyici, ajanın bir bölüm bulmasına veya incelemeniz için yorum bırakmasına olanak tanıyabilir.
Web sitesinin neler sağladığını görmek için tarayıcının adres çubuğunda Site araçları seçeneğini belirleyin. Araçları tek tek incelemek için Kullanılabilir site araçları seçeneğini belirleyin. Tarayıcı, web sitesi her isteği gerçekleştirmeden önce isteği denetler ve ajan nelerin değiştiğini görmek için sayfayı inceleyebilir. Yakın zamandaki etkinlikler kullanılabiliyorsa Kaynaklar bölümünü açıp bu çağrıları incelemek için Son kullanılanlar seçeneğini belirleyin.
Bu örnekte Margin tarafından sağlanan araçları incelemek için Kullanılabilir site araçları bölümünü genişletin.
Araçlar, onları sağlayan sayfaya aittir. Bir sayfayı kapatmak veya başka bir sayfaya gitmek, araçlarını kullanılamaz hâle getirebilir. Uygun bir araç yoksa ajan yine de normal tarayıcı yeteneklerini kullanabilir.
Örnek: OpenAI belgelerini keşfetme
ChatGPT Learn ve OpenAI Developers, belgeleri bulup okumaya yönelik site araçları sunar. Learn'ü masaüstü uygulamasının tarayıcısında, gönderilmeye hazır bu istemi içeren yeni bir sohbetin yanında açmak için oluşturucuda ChatGPT'de aç seçeneğini belirleyin.
İstem:
Find the documentation for building reusable skills, open the relevant page, and explain when I should turn a skill into a plugin.Ajan; ilgili sayfayı aramak, okumak ve açmak için bu araçları kullanabilir:
| Araç | İşlevi |
|---|---|
search_openai_docs |
OpenAI belgelerinde arama yapar. |
lookup_page |
Bir belge sayfasını yoluna veya URL'sine göre okur. |
lookup_context |
Geçerli belge rotasını ve seçili metni okur. |
navigate_to_page |
Geçerli belge sitesinde eşleşen bir sayfayı açar. |
generate_custom_guide |
Özel bir derleme veya öğrenme kılavuzu başlatır; durumunu ve bağlantısını döndürür. |
Docs ajanı, özel bir kılavuzu eşzamansız olarak oluşturur. Bağlantısının alınması, oluşturmanın tamamlandığı anlamına gelmez.
Güvenlik ve kullanıcı denetimleri
Web sitesinin sağladığı araç tanımları ve sonuçları güvenilmeyen içeriktir. Bir aracın adı veya yalnızca veri okuduğu iddiası, ne yaptığının kanıtı değildir. Web sitesi talimatları, ajana ilgisiz bilgileri paylaşma veya hassas eylemler gerçekleştirme izni vermez.
Yerleşik tarayıcıda her araç çağrısı, çalıştırılmadan önce güvenlik incelemesinden geçer. Mesaj gönderme, satın alma, veri silme veya izinleri değiştirme gibi önemli sonuçlar doğuran eylemler de dâhil olmak üzere normal web sitesi erişim ve onay ilkeleri geçerliliğini korur. Tarayıcı, her çağrıyı kaynak sayfasına ve araç kaydına bağlar. Bu denetimler riski azaltır; bir web sitesini veya çıktısını güvenilir hâle getirmez.
Ayarlar > Tarayıcı > İzinler bölümünde Site araçlarını etkinleştir seçeneğini kapatabilirsiniz. Hassas bilgileri paylaşmadan veya bir değişikliğe güvenmeden önce siteyi, istenen eylemi ve sonucu inceleyin.
Güvenlik açıklarını OpenAI'ın Security Bug Bounty programı üzerinden bildirin. AI güvenliği riskleri için Safety Bug Bounty programına bakın. Her programın kapsam ve gönderim talimatlarını izleyin.
Web sitenize WebMCP ekleme
Codex'ten üzerinde çalıştığınız web uygulamasına veya Site'a WebMCP desteği eklemesini isteyebilirsiniz. Bir ajanın neler yapabilmesi gerektiğini açıklayın ve Codex'ten uygulamanın mevcut mantığını ve izinlerini yeniden kullanmasını isteyin.
Uygulamanızın zaten desteklediği bir işlemle başlayın. Örneğin:
- Ajanın bir tarih aralığı belirlemesine ve bir grafiğin arkasındaki verileri incelemesine olanak tanıyan bir pano.
- Ajanın bir bölüm bulmasına, düzenleme önermesine veya incelemeniz için yorum bırakmasına olanak tanıyan bir belge düzenleyici.
- Siz haritayı incelerken ajanın seçenekleri karşılaştırmasına ve gezi planını güncellemesine olanak tanıyan bir seyahat planlayıcı.
Kodu kendiniz de yazabilirsiniz. Sayfanızın JavaScript modülünde tarayıcı desteğini denetleyin ve bir araç kaydedin. Bu salt okunur örnek, geçerli sayfanın başlığını döndürür:
if (typeof document.modelContext?.registerTool === "function") {
await document.modelContext.registerTool({
name: "get_page_title",
description: "Read the title of the current page.",
inputSchema: {
type: "object",
properties: {},
additionalProperties: false,
},
annotations: { readOnlyHint: true },
execute: async () => ({ title: document.title }),
});
}Uyumlu bir ajan get_page_title aracını keşfedebilir ve sayfanın geçerli
başlığını alabilir. Bağımsız değişken kabul eden bir araç için bunları girdi
şemasında açıklayın ve uygulamanızın mevcut mantığını çağırmak üzere execute işleyicisinde
kullanın.
Girdileri dar kapsamlı tutun, yan etkileri açıklayın ve sonucu doğrulamaya yetecek kadar bilgi döndürün. Uygulamanızın mevcut kimlik doğrulama, yetkilendirme ve girdi doğrulama mekanizmalarını kullanın. İnsanlar ve WebMCP'yi desteklemeyen tarayıcılar için normal arayüzü koruyun.
API ayrıntıları ve örnekler için WebMCP belirtimine ve Chrome geliştirici kılavuzuna bakın.