Context API wyodrębnia pełny kontekst z dowolnej strony internetowej
Korzystaj z Perplexity Context API, aby dostarczać agentom AI czysty kod Markdown, linki i istotne fragmenty stron internetowych z pamięci podręcznej lub pobieranych na żywo.

Gdy ktoś zadaje pytanie chatbotowi, agent AI może musieć przeczytać kilka stron internetowych, aby na nie odpowiedzieć. Standardowe wyniki wyszukiwania często zwracają tylko krótkie fragmenty. Bezpośrednie pobranie strony może zwrócić surowy kod HTML pełen elementów nawigacji, banerów dotyczących plików cookie i reklam. Agenci potrzebują kontekstu strony w formacie, z którego może skorzystać model, a programiści – sposobu na określenie, jak aktualny musi być ten kontekst.
Dziś wprowadzamy Perplexity Context API – interfejs, który odczytuje do 10 adresów URL i dla każdej strony zwraca czysty kod Markdown, HTML, linki oraz fragmenty dopasowane do zapytania. Informacje pochodzą z ogromnego indeksu internetowego Perplexity lub z pobierania na żywo. Agenci mogą określić wymaganą aktualność danych dla każdego żądania i zweryfikować źródło każdego wyniku.
Context API obsługuje różne formaty
Agenci mogą wysłać żądanie, podając listę adresów URL i określając formaty wyjściowe. Interfejs API zwraca wynik dla każdego adresu URL w tej samej kolejności.
Context API obsługuje różne formaty odpowiedzi:
- Markdown: Treść strony w postaci czystego kodu Markdown, gotowa do umieszczenia w kontekście modelu.
- HTML: Kod HTML strony dla aplikacji, które samodzielnie go parsują.
- Linki: Linki ze strony w postaci bezwzględnych adresów URL, bez duplikatów i w kolejności występowania na stronie, dzięki czemu agent może zdecydować, dokąd przejść dalej.
- Fragmenty: Fragmenty strony najbardziej istotne dla podanego zapytania, mieszczące się w limicie tokenów ustawionym przez programistę dla każdej strony.
Context API wybiera z każdej strony fragmenty istotne dla zapytania, zamiast generować podsumowanie. Dzięki temu model otrzymuje oryginalne sformułowania ze strony, ale tylko w wybranych fragmentach, więc ma mniej tekstu do przetworzenia.
Każdy pomyślny wynik zawiera też metadane, takie jak tytuł, opis, język, autor i data publikacji, a także tagi Open Graph strony. Aby utworzyć kod Markdown, Context API dzieli stronę na bloki, a model ocenia, czy każdy blok jest treścią główną, czy powtarzalnym elementem szablonu. Zachowywane są tylko bloki z treścią.
Niezbędne w zadaniach wymagających pełnego obrazu
Znalezienie odpowiedniej strony nie zawsze wystarcza do wykonania zadania. Dzięki Context API agenci mogą pobierać potrzebne treści z wybranych adresów URL, aby realizować złożone zadania.
- Wdrażanie integracji API: Wynik wyszukiwania może wskazać właściwą dokumentację, ale bez wymaganych parametrów, instrukcji uwierzytelniania czy opisu przypadków błędów. Context API może pomóc agentowi programistycznemu pobrać dokumentację i dokumentację referencyjną API, aby na podstawie tych szczegółów napisać integrację.
- Porównywanie aktualnych cen: Podana cena może zależeć od limitów użycia, warunków rozliczeń lub kryteriów kwalifikowalności, których brakuje we fragmencie z wyników wyszukiwania. Agent może zażądać pobrania na żywo wybranych stron z cennikami i zapoznać się z tymi warunkami przed dokonaniem porównania.
- Odpowiadanie na pytania o zasady: Fragment zasad zwrotów może podawać standardowy termin zwrotu, ale pomijać wyjątki dotyczące określonych produktów lub regionów. Agent obsługi klienta może pobrać stronę z zasadami, aby jego odpowiedź uwzględniała te wyjątki.
- Analiza wielu źródeł: Fragment z wyników wyszukiwania może przedstawiać ustalenie bez metodologii, zastrzeżeń czy szerszej argumentacji. Agent badawczy może pobrać wybrane artykuły i raporty, a następnie porównać dowody, zamiast polegać wyłącznie na fragmentach.
Kontroluj aktualność danych i niezawodnie obsługuj adresy URL
Domyślnie Context API najpierw sprawdza, czy w indeksie internetowym Perplexity znajduje się kopia strony pobrana w ciągu ostatnich dwóch dni. Jeśli jej nie ma, pobiera stronę na żywo. Programiści mogą zmienić wartość max_age_seconds na 0, aby zawsze odczytywać strony na żywo – w przypadku cen, wyników sportowych i najświeższych wiadomości. W przypadku rzadko zmieniających się materiałów referencyjnych mogą tę wartość zwiększyć. Ustaw cache_only na true dla zadań, które nigdy nie powinny wywoływać żądania na żywo.
Każdy wynik zawiera informację, czy treść pochodzi z zapisanej kopii, czy z pobrania na żywo, oraz kiedy została pobrana.
Adresy URL w żądaniu są pobierane równolegle, każdy z własnym limitem czasu i własnym statusem. Jedna wolna lub uszkodzona strona nie powoduje niepowodzenia pozostałych. Status wskazuje, co stało się z każdym adresem URL, dzięki czemu agent może ponowić próbę tylko dla stron, które przekroczyły limit czasu, i zachować resztę.
Context API zwraca użyteczne i kompletne treści
Porównaliśmy Context API z Firecrawl, Exa, Parallel, Keenable i Context.dev na próbie 1000 adresów URL wybranych z rzeczywistych żądań pobrania wysyłanych przez agentów. Zbiór obejmuje 715 witryn, w tym źródła rządowe i akademickie oraz strony w językach innych niż angielski. Następnie oddzielny model oceniający ocenił wyniki, nie wiedząc, który dostawca wygenerował każdy z nich.
Wykres przedstawia wyniki według trzech kryteriów:
- Użyteczność: Odsetek adresów URL, dla których zwrócono rzeczywistą treść strony, a nie stronę błędu lub pusty wynik.
- Kompletność faktów: Model oceniający zbiera kluczowe fakty znalezione na stronie w wynikach wszystkich dostawców, a następnie sprawdza, które z nich zawiera każdy wynik. Nieudane pobranie otrzymuje zero punktów.
- Precyzja treści: odsetek zwróconego tekstu, który stanowi treść strony, a nie powiadomienia o plikach cookie, elementy nawigacji czy reklamy, uśredniony dla wszystkich adresów URL. Nieudane pobranie otrzymuje wynik zero.
W tej ewaluacji Context API zwróciło użyteczną treść dla 92,3% adresów URL, odtworzyło 87,9% kluczowych faktów i uzyskało wynik 80,3% w zakresie precyzji treści.
Cennik
Context API kosztuje 1 USD za 1000 pobranych adresów URL. Programiści płacą za każdy adres URL, który zwraca status ok. Adresy URL, których nie udało się pobrać, nie są rozliczane.
Pierwsze kroki
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"]
}'Każdy wynik zawiera kod Markdown strony, fragmenty pasujące do zapytania, metadane strony i status. Przed użyciem treści sprawdź status każdego wyniku.
Przeczytaj dokumentację Context API lub zapoznaj się z dokumentacją referencyjną API.