Context API извлича пълния контекст от всяка уеб страница
Използвайте Perplexity Context API, за да предоставите на AI агентите чист Markdown, връзки и релевантни пасажи от кеширани уеб страници или такива, заредени в реално време.

Когато някой зададе въпрос на чатбот, може да се наложи AI агентът да прочете няколко уеб страници, за да отговори. Стандартните резултати от търсене често връщат само кратки откъси. Директното извличане на страница може да върне суров HTML код, пълен с навигация, банери за бисквитки и реклами. Агентите се нуждаят от контекста на страницата във формат, който моделът може да използва, а разработчиците – от начин да контролират колко актуален трябва да бъде този контекст.
Днес представяме Perplexity Context API, който чете до 10 URL адреса и връща чист Markdown, HTML, връзки и откъси според заявката за всяка страница. Информацията идва от обширния уеб индекс на Perplexity или от извличане на живо. Агентите могат да задават актуалността на всяка заявка и да проверяват източника на всеки резултат.
Context API поддържа разнообразни формати
Агентите могат да изпратят заявка, като предоставят списък с URL адреси и посочат изходните формати. API връща резултат за всеки URL адрес в същия ред.
Context API поддържа разнообразни формати на отговора:
- Markdown: Съдържанието на страницата като чист Markdown, готово за поставяне в контекста на модела.
- HTML: HTML кодът на страницата – за приложения, които извършват собствен синтактичен анализ.
- Връзки: Връзките на страницата като абсолютни URL адреси, без дубликати и в реда, в който се появяват на страницата, за да може агентът да реши накъде да продължи.
- Откъси: Пасажите от страницата, които са най-релевантни на подадената заявка, в рамките на лимита на токени, зададен от разработчика за всяка страница.
Context API избира от всяка страница пасажи, които са релевантни на заявката, вместо да генерира обобщение. В резултат моделът получава оригиналния текст на страницата, но само избраните пасажи, така че има по-малко текст за обработка.
Всеки успешен резултат включва и метаданни като заглавие, описание, език, автор и дата на публикуване, както и Open Graph таговете на страницата. За да създаде Markdown съдържанието, Context API разделя страницата на блокове, а модел оценява всеки блок като основно съдържание или шаблонен текст. Запазват се само блоковете със съдържание.
Незаменим за задачи, които изискват пълната картина
Намирането на релевантна страница не винаги е достатъчно, за да се свърши дадена работа. С Context API агентите могат да извличат нужното им съдържание от избрани URL адреси, за да изпълняват сложни задачи.
- Внедряване на интеграция с API: Резултат от търсене може да посочи правилната документация, без да включва необходимите параметри, инструкциите за удостоверяване или случаите на грешки. Context API може да помогне на агент за програмиране да извлече документацията и справочниците за API, за да напише интеграция въз основа на тези подробности.
- Сравняване на актуални цени: Посочената цена може да зависи от лимити за използване, условия за фактуриране или изисквания за допустимост, които липсват в откъса от търсенето. Агентът може да поиска извличане на живо на избрани страници с цени и да прочете тези условия, преди да направи сравнение.
- Отговаряне на въпроси за политики: Откъс от политика за връщане може да посочва стандартния срок за връщане, но да пропуска изключенията за определени продукти или региони. Агент за поддръжка може да извлече страницата с политиката, така че отговорът му да отчита тези изключения.
- Проучване в множество източници: Откъс от търсене може да покаже дадена констатация без методологията, уговорките или съпътстващата аргументация. Агент за проучване може да извлече избраните статии и доклади и след това да сравни доказателствата, вместо да разчита само на откъси.
Контролирайте актуалността и обработвайте URL адресите надеждно
По подразбиране Context API първо проверява уеб индекса на Perplexity за копие на страницата, извлечено през последните два дни. Ако няма такова, извлича страницата на живо. Разработчиците могат да променят max_age_seconds на 0, за да четат винаги страниците на живо – за цени, спортни резултати и извънредни новини. За справочни материали, които рядко се променят, могат да увеличат стойността. Задайте cache_only на true за работни натоварвания, които никога не бива да задействат заявка на живо.
Всеки резултат записва дали съдържанието идва от съхранено копие, или от извличане на живо, както и кога е извлечено.
URL адресите в една заявка се извличат паралелно, всеки със собствен времеви лимит и собствен статус. Една бавна или неработеща страница не проваля останалите. Статусът показва какво се е случило с всеки URL адрес, така че агентът да може да опита отново само страниците, за които е изтекло времето, и да запази останалите.
Context API връща използваемо и пълно съдържание
Тествахме Context API спрямо Firecrawl, Exa, Parallel, Keenable и Context.dev върху 1000 URL адреса, избрани от реални заявки за извличане от агенти. Наборът обхваща 715 сайта и включва правителствени и академични източници, както и страници на езици, различни от английски. След това отделен модел оценител оцени резултатите, без да знае кой доставчик е създал всеки от тях.
Диаграмата измерва представянето по три критерия:
- Използваемост: Делът на URL адресите, за които е върнато реалното съдържание на страницата, а не страница за грешка или празен резултат.
- Пълнота на фактите: Оценителят събира ключовите факти, открити на дадена страница при всички доставчици, след което проверява кои от тях се съдържат във всеки резултат. Неуспешното извличане получава нулева оценка.
- Прецизност на съдържанието: Делът на върнатия текст, който е съдържание на страницата, а не известия за бисквитки, навигация или реклами, осреднен за всички URL адреси. Неуспешното извличане получава нула точки.
При тази оценка Context API върна използваемо съдържание за 92,3% от URL адресите, извлече 87,9% от ключовите факти и постигна прецизност от 80,3% по показателя „прецизност на съдържанието“.
Цени
Context API струва 1 $ за 1000 извлечени URL адреса. Разработчиците плащат за всеки URL адрес, който връща статус ok. URL адресите, които са неуспешни, не се таксуват.
Първи стъпки
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"]
}'Всеки резултат се връща с Markdown съдържанието на страницата, пасажите, които отговарят на заявката, метаданните на страницата и статус. Проверете статуса на всеки резултат, преди да използвате съдържанието му.
Прочетете документацията на Context API или вижте справочника за API.