Context API mengekstrak konteks lengkap dari halaman web mana pun
Gunakan Perplexity Context API untuk memberi agen AI Markdown yang bersih, tautan, dan bagian yang relevan dari halaman web yang tersimpan di cache maupun yang diambil secara langsung.

Saat seseorang mengajukan pertanyaan kepada chatbot, agen AI mungkin perlu membaca beberapa halaman web untuk menjawabnya. Hasil penelusuran standar sering kali hanya menampilkan cuplikan. Mengambil halaman secara langsung dapat menghasilkan HTML mentah yang penuh dengan navigasi, banner cookie, dan iklan. Agen memerlukan konteks halaman dalam format yang dapat digunakan oleh model, sementara pengembang memerlukan cara untuk mengontrol seberapa mutakhir konteks tersebut.
Hari ini kami meluncurkan Perplexity Context API, yang membaca hingga 10 URL dan mengembalikan markdown yang bersih, HTML, tautan, serta cuplikan berbasis kueri untuk setiap halaman. Informasinya berasal dari indeks web Perplexity yang sangat luas atau dari pengambilan langsung. Agen dapat menentukan tingkat kemutakhiran setiap permintaan dan memvalidasi sumber setiap hasil.
Context API mendukung beragam format
Agen dapat memulai permintaan dengan memberikan daftar URL dan menentukan format output. API mengembalikan hasil untuk setiap URL dalam urutan yang sama.
Context API mendukung beragam format respons:
- Markdown: Konten halaman dalam bentuk Markdown yang bersih, siap dimasukkan ke dalam konteks model.
- HTML: HTML halaman, untuk aplikasi yang menjalankan parsing sendiri.
- Tautan: Tautan pada halaman dalam bentuk URL absolut, tanpa duplikat dan sesuai urutan di halaman, sehingga agen dapat memutuskan ke mana harus melangkah berikutnya.
- Cuplikan: Bagian halaman yang paling relevan dengan kueri yang diberikan, dalam batas token yang ditetapkan oleh pengembang untuk setiap halaman.
Context API memilih bagian dari setiap halaman yang relevan dengan kueri, alih-alih membuat ringkasan. Hasilnya, model menerima kata-kata asli dari halaman, tetapi hanya bagian yang dipilih, sehingga teks yang perlu diproses lebih sedikit.
Setiap hasil yang berhasil juga menyertakan metadata seperti judul, deskripsi, bahasa, penulis, dan tanggal publikasi, serta tag Open Graph halaman. Untuk menyusun Markdown, Context API membagi halaman menjadi blok-blok, lalu sebuah model menilai setiap blok sebagai konten utama atau boilerplate. Hanya blok konten yang dipertahankan.
Penting untuk tugas yang memerlukan gambaran lengkap
Menemukan halaman yang relevan tidak selalu cukup untuk menyelesaikan suatu pekerjaan. Dengan Context API, agen dapat mengambil konten yang mereka perlukan dari URL yang dipilih untuk menyelesaikan tugas yang kompleks.
- Mengimplementasikan integrasi API: Hasil penelusuran mungkin menunjukkan dokumentasi yang tepat tanpa menyertakan parameter yang diperlukan, petunjuk autentikasi, atau kasus error. Context API dapat membantu agen coding mengambil dokumentasi dan referensi API untuk menulis integrasi berdasarkan detail tersebut.
- Membandingkan harga terkini: Harga yang tercantum mungkin bergantung pada batas penggunaan, ketentuan penagihan, atau syarat kelayakan yang tidak ada dalam kutipan hasil penelusuran. Agen dapat meminta pengambilan langsung atas halaman harga yang dipilih dan membaca syarat-syarat tersebut sebelum membuat perbandingan.
- Menjawab pertanyaan tentang kebijakan: Kutipan kebijakan pengembalian mungkin menyebutkan jangka waktu pengembalian standar, tetapi tidak mencantumkan pengecualian untuk produk atau wilayah tertentu. Agen dukungan dapat mengambil halaman kebijakan tersebut sehingga jawabannya memperhitungkan pengecualian itu.
- Meneliti di berbagai sumber: Kutipan hasil penelusuran mungkin menampilkan suatu temuan tanpa metodologi, batasan, atau argumen yang melatarbelakanginya. Agen penelitian dapat mengambil artikel dan laporan yang dipilih, lalu membandingkan buktinya alih-alih hanya mengandalkan kutipan.
Kontrol kemutakhiran dan tangani URL secara andal
Secara default, Context API terlebih dahulu memeriksa indeks web Perplexity untuk mencari salinan halaman yang diambil dalam dua hari terakhir. Jika tidak ada, API akan mengambil halaman tersebut secara langsung. Pengembang dapat mengubah max_age_seconds menjadi 0 agar selalu membaca halaman secara langsung, misalnya untuk harga, skor, dan berita terkini. Untuk materi referensi yang jarang berubah, mereka dapat menaikkan nilainya. Setel cache_only ke true untuk beban kerja yang tidak boleh memicu permintaan langsung.
Setiap hasil mencatat apakah konten berasal dari salinan tersimpan atau pengambilan langsung, serta kapan konten tersebut diambil.
URL dalam satu permintaan diambil secara paralel, masing-masing dengan batas waktu dan statusnya sendiri. Satu halaman yang lambat atau rusak tidak membuat halaman lainnya gagal. Status menunjukkan apa yang terjadi pada setiap URL, sehingga agen dapat mencoba ulang hanya halaman yang mengalami timeout dan mempertahankan sisanya.
Context API mengembalikan konten yang lengkap dan dapat digunakan
Kami menguji Context API dibandingkan dengan Firecrawl, Exa, Parallel, Keenable, dan Context.dev pada 1.000 URL yang diambil sebagai sampel dari permintaan pengambilan agen yang nyata. Kumpulan ini mencakup 715 situs, termasuk sumber pemerintah dan akademis serta halaman berbahasa selain Inggris. Selanjutnya, model juri terpisah menilai output tanpa mengetahui penyedia mana yang menghasilkan masing-masing output.
Grafik ini mengukur performa berdasarkan tiga kriteria:
- Dapat digunakan: Persentase URL yang mengembalikan konten asli halaman, bukan halaman error atau hasil kosong.
- Recall fakta: Juri mengumpulkan fakta-fakta kunci yang ditemukan pada halaman dari semua penyedia, lalu memeriksa fakta mana saja yang terdapat dalam setiap output. Pengambilan yang gagal mendapat skor nol.
- Presisi konten: Proporsi teks yang dikembalikan yang merupakan konten halaman, bukan pemberitahuan cookie, navigasi, atau iklan, dirata-ratakan untuk semua URL. Pengambilan yang gagal mendapat skor nol.
Dalam evaluasi ini, Context API mengembalikan konten yang dapat digunakan untuk 92,3% URL, memulihkan 87,9% fakta kunci, dan meraih skor 80,3% pada presisi konten.
Harga
Biaya Context API adalah $1 per 1.000 URL yang diambil. Pengembang membayar untuk setiap URL yang mengembalikan status ok. URL yang gagal tidak dikenai biaya.
Memulai
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"]
}'Setiap hasil dikembalikan beserta Markdown halaman, bagian yang cocok dengan kueri, metadata halaman, dan status. Periksa status setiap hasil sebelum menggunakan kontennya.
Baca dokumentasi Context API atau lihat referensi API.