Context API, herhangi bir web sayfasından tam bağlamı çıkarır

Yapay zeka ajanlarına önbelleğe alınmış veya canlı web sayfalarından temiz Markdown, bağlantılar ve alakalı bölümler sağlamak için Perplexity Context API'yi kullanın.

Context API artwork with a luminous mineral cross-section and geometric lines.

Biri bir sohbet botuna soru sorduğunda, bir yapay zeka ajanının bu soruyu yanıtlamak için birkaç web sayfasını okuması gerekebilir. Standart arama sonuçları çoğu zaman yalnızca kısa alıntılar döndürür. Bir sayfayı doğrudan getirmek ise gezinme menüleri, çerez bildirimleri ve reklamlarla dolu ham HTML döndürebilir. Ajanların sayfanın bağlamına bir modelin kullanabileceği bir biçimde ihtiyacı vardır; geliştiricilerin ise bu bağlamın ne kadar güncel olması gerektiğini kontrol edebilecekleri bir yola ihtiyacı vardır.

Bugün, en fazla 10 URL'yi okuyan ve her sayfa için temiz Markdown, HTML, bağlantılar ve sorguya dayalı alıntılar döndüren Perplexity Context API'yi kullanıma sunuyoruz. Bilgiler, Perplexity'nin geniş web dizininden veya canlı bir getirme işleminden gelir. Ajanlar her isteğin güncellik düzeyini belirleyebilir ve her sonucun kaynağını doğrulayabilir.

Context API çeşitli biçimleri destekler

Ajanlar, bir URL listesi sağlayıp çıktı biçimlerini belirterek istek başlatabilir. API, her URL için aynı sırayla bir sonuç döndürür.

Context API çeşitli yanıt biçimlerini destekler:

  • Markdown: Bir modelin bağlamına eklenmeye hazır, temiz Markdown biçiminde sayfa içeriği.
  • HTML: Kendi ayrıştırma işlemlerini yürüten uygulamalar için sayfanın HTML'i.
  • Bağlantılar: Bir ajanın sonra nereye gideceğine karar verebilmesi için sayfadaki bağlantılar; mutlak URL'ler olarak, yinelenenler olmadan ve sayfadaki sırasıyla.
  • Alıntılar: Sayfanın, sağlanan bir sorguyla en alakalı bölümleri; geliştiricinin her sayfa için belirlediği token sınırı dahilinde.

Context API, bir özet oluşturmak yerine her sayfadan sorguyla alakalı bölümleri seçer. Böylece model sayfanın orijinal ifadelerini alır, ancak yalnızca seçilen bölümleri aldığı için işlenecek metin daha azdır.

Başarılı her sonuç ayrıca başlık, açıklama, dil, yazar ve yayın tarihi gibi meta verilerin yanı sıra sayfanın Open Graph etiketlerini de içerir. Context API, Markdown'ı oluşturmak için sayfayı bloklara ayırır ve bir model her bloğu ana içerik veya standart kalıp metin olarak puanlar. Yalnızca içerik blokları tutulur.

Bütünsel bakış gerektiren görevler için vazgeçilmez

Alakalı bir sayfa bulmak, bir işi tamamlamak için her zaman yeterli değildir. Ajanlar, Context API'yi kullanarak karmaşık görevleri tamamlamak için ihtiyaç duydukları içeriği seçilen URL'lerden alabilir.

  • API entegrasyonu uygulama: Bir arama sonucu, gerekli parametreleri, kimlik doğrulama talimatlarını veya hata durumlarını içermeden doğru belgeleri işaret edebilir. Context API, bir kodlama ajanının bu ayrıntılara dayalı bir entegrasyon yazmak için belgeleri ve API referanslarını almasına yardımcı olabilir.
  • Güncel fiyatları karşılaştırma: Listelenen bir fiyat, arama alıntısında yer almayan kullanım sınırlarına, faturalandırma koşullarına veya uygunluk şartlarına bağlı olabilir. Bir ajan, seçilen fiyatlandırma sayfalarının canlı olarak getirilmesini isteyebilir ve karşılaştırma yapmadan önce bu koşulları okuyabilir.
  • Politika sorularını yanıtlama: Bir iade politikası alıntısı, standart iade süresini belirtip belirli ürünlere veya bölgelere yönelik istisnaları atlayabilir. Bir destek ajanı, yanıtının bu istisnaları da hesaba katması için politika sayfasını alabilir.
  • Birden fazla kaynakta araştırma yapma: Bir arama alıntısı, bir bulguyu metodolojisi, çekinceleri veya çevresindeki argüman olmadan öne çıkarabilir. Bir araştırma ajanı, seçilen makaleleri ve raporları alıp yalnızca alıntılara güvenmek yerine kanıtları karşılaştırabilir.

Güncelliği kontrol edin ve URL'leri güvenilir şekilde işleyin

Context API, varsayılan olarak önce Perplexity'nin web dizininde sayfanın son iki gün içinde getirilmiş bir kopyası olup olmadığını kontrol eder. Böyle bir kopya yoksa sayfayı canlı olarak getirir. Geliştiriciler; fiyatlar, skorlar ve son dakika haberleri için her zaman canlı sayfaları okumak üzere max_age_seconds değerini 0 olarak değiştirebilir. Nadiren değişen başvuru materyalleri için bu değeri artırabilirler. Hiçbir zaman canlı istek tetiklememesi gereken iş yükleri için cache_only değerini true olarak ayarlayın.

Her sonuç, içeriğin depolanmış bir kopyadan mı yoksa canlı bir getirme işleminden mi geldiğini ve ne zaman getirildiğini kaydeder.

Bir istekteki URL'ler, her biri kendi süre bütçesi ve kendi durumuyla paralel olarak getirilir. Yavaş veya bozuk bir sayfa, diğerlerinin başarısız olmasına yol açmaz. Durum, her URL'de ne olduğunu gösterir; böylece bir ajan yalnızca zaman aşımına uğrayan sayfaları yeniden deneyip geri kalanları tutabilir.

Context API kullanılabilir ve eksiksiz içerik döndürür

Context API'yi, gerçek ajan getirme isteklerinden örneklenen 1.000 URL üzerinde Firecrawl, Exa, Parallel, Keenable ve Context.dev ile karşılaştırarak test ettik. Bu küme 715 siteyi kapsıyor; devlet ve akademik kaynakların yanı sıra İngilizce olmayan sayfaları da içeriyor. Ardından ayrı bir değerlendirici model, hangi çıktıyı hangi sağlayıcının ürettiğini bilmeden çıktıları puanladı.

Grafik, performansı üç ölçüte göre değerlendirir:

  • Kullanılabilirlik: Hata sayfası veya boş sonuç yerine sayfanın gerçek içeriğiyle dönen URL'lerin oranı.
  • Olgu hatırlama: Değerlendirici model, tüm sağlayıcılarda bir sayfada bulunan temel olguları toplar, ardından her çıktının bunlardan hangilerini içerdiğini kontrol eder. Başarısız bir getirme işlemi sıfır puan alır.
  • İçerik kesinliği: Döndürülen metnin çerez bildirimleri, gezinme öğeleri veya reklamlar değil, sayfa içeriği olan kısmının oranı; tüm URL'ler üzerinden ortalaması alınır. Başarısız bir getirme işlemi sıfır puan alır.

Bu değerlendirmede Context API, URL'lerin %92,3'ü için kullanılabilir içerik döndürdü, temel bilgilerin %87,9'unu elde etti ve içerik kesinliği ölçütünde %80,3 kesinlik puanı aldı.

Fiyatlandırma

Context API'nin ücreti, getirilen 1.000 URL başına 1 $'dır. Geliştiriciler, ok döndüren her URL için ödeme yapar. Başarısız olan URL'ler faturalandırılmaz.

Başlarken

bash
curl --request POST https://api.perplexity.ai/v1/context \ --header "Authorization: Bearer $PERPLEXITY_API_KEY" \ --header "Content-Type: application/json" \ --data '{ "urls": ["https://info.cern.ch/hypertext/WWW/TheProject.html"], "formats": ["markdown"] }'

Her sonuç; sayfanın Markdown içeriği, sorguyla eşleşen bölümler, sayfa meta verileri ve bir durum bilgisiyle birlikte döner. İçeriğini kullanmadan önce her sonucun durumunu kontrol edin.

Context API belgelerini okuyun veya API referansına göz atın.

  1. Orchestrator: Güvenilir çıkarım için tek APIGeliştiriciler17 Kas 2026
  2. Perplexity'nin Monitor API'siyle tanışınGeliştiriciler16 Kas 2026