Context API로 모든 웹 페이지에서 전체 컨텍스트 추출

Perplexity Context API를 사용해 캐시된 웹 페이지나 실시간 웹 페이지에서 가져온 깔끔한 Markdown, 링크, 관련 구절을 AI 에이전트에 제공하세요.

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

누군가 챗봇에 질문하면 AI 에이전트는 답변을 위해 여러 웹 페이지를 읽어야 할 수 있습니다. 일반적인 검색 결과는 스니펫만 반환하는 경우가 많습니다. 페이지를 직접 가져오면 내비게이션, 쿠키 배너, 광고로 가득한 원시 HTML이 반환될 수 있습니다. 에이전트에는 모델이 활용할 수 있는 형식의 페이지 컨텍스트가 필요하고, 개발자에게는 그 컨텍스트가 얼마나 최신이어야 하는지 제어할 방법이 필요합니다.

오늘 Perplexity Context API를 출시합니다. 이 API는 최대 10개의 URL을 읽고 각 페이지에 대해 깔끔한 Markdown, HTML, 링크, 쿼리 기반 스니펫을 반환합니다. 정보는 Perplexity의 방대한 웹 인덱스 또는 실시간 가져오기를 통해 제공됩니다. 에이전트는 요청별로 최신성을 지정하고 각 결과의 출처를 검증할 수 있습니다.

Context API는 다양한 형식을 지원합니다

에이전트는 URL 목록을 제공하고 출력 형식을 지정해 요청을 시작할 수 있습니다. API는 각 URL에 대한 결과를 동일한 순서로 반환합니다.

Context API는 다양한 응답 형식을 지원합니다.

  • Markdown: 모델의 컨텍스트에 바로 넣을 수 있는 깔끔한 Markdown 형식의 페이지 콘텐츠입니다.
  • HTML: 자체 파싱을 수행하는 애플리케이션을 위한 페이지 HTML입니다.
  • 링크: 페이지에 있는 링크를 중복 없이 페이지 내 순서대로 절대 URL로 제공하므로, 에이전트가 다음에 어디로 이동할지 결정할 수 있습니다.
  • 스니펫: 제공된 쿼리와 가장 관련성이 높은 페이지 구절로, 개발자가 페이지별로 설정한 토큰 한도 내에서 반환됩니다.

Context API는 요약을 생성하는 대신 각 페이지에서 쿼리와 관련된 구절을 선별합니다. 따라서 모델은 페이지의 원래 표현을 그대로 받되 선별된 구절만 받으므로 처리할 텍스트가 줄어듭니다.

또한 성공한 모든 결과에는 제목, 설명, 언어, 작성자, 게시일 등의 메타데이터와 페이지의 Open Graph 태그가 포함됩니다. Context API는 Markdown을 생성하기 위해 페이지를 블록으로 나누고, 모델이 각 블록을 주요 콘텐츠 또는 보일러플레이트로 판별해 점수를 매깁니다. 콘텐츠 블록만 유지됩니다.

전체 맥락이 필요한 작업에 필수

관련 페이지를 찾는 것만으로는 작업을 완료하기에 충분하지 않을 때가 있습니다. Context API를 사용하면 에이전트가 선택한 URL에서 필요한 콘텐츠를 가져와 복잡한 작업을 완료할 수 있습니다.

  • API 통합 구현: 검색 결과로 올바른 문서를 찾더라도 필수 매개변수, 인증 방법, 오류 사례는 포함되지 않을 수 있습니다. Context API를 활용하면 코딩 에이전트가 문서와 API 레퍼런스를 가져와 이러한 세부 정보를 바탕으로 통합을 작성할 수 있습니다.
  • 현재 가격 비교: 표시된 가격은 검색 발췌문에 나오지 않는 사용량 한도, 결제 조건, 자격 요건에 따라 달라질 수 있습니다. 에이전트는 선택한 가격 페이지를 실시간으로 가져오도록 요청하고, 비교하기 전에 해당 조건을 읽을 수 있습니다.
  • 정책 관련 질문 답변: 반품 정책 발췌문에는 기본 반품 기간은 나와 있어도 특정 제품이나 지역에 대한 예외는 빠져 있을 수 있습니다. 고객 지원 에이전트는 정책 페이지를 가져와 이러한 예외까지 반영한 답변을 제공할 수 있습니다.
  • 여러 출처에 걸친 리서치: 검색 발췌문은 연구 결과를 보여주더라도 방법론, 단서 조건, 전후 논거는 담고 있지 않을 수 있습니다. 리서치 에이전트는 선택한 기사와 보고서를 가져온 다음, 발췌문에만 의존하지 않고 근거를 비교할 수 있습니다.

최신성 제어 및 안정적인 URL 처리

기본적으로 Context API는 먼저 Perplexity의 웹 인덱스에서 최근 2일 이내에 가져온 페이지 사본이 있는지 확인합니다. 사본이 없으면 페이지를 실시간으로 가져옵니다. 가격, 경기 점수, 속보처럼 항상 실시간 페이지를 읽어야 하는 경우 개발자는 max_age_seconds 값을 0으로 변경할 수 있습니다. 거의 바뀌지 않는 참고 자료의 경우에는 이 값을 높일 수 있습니다. 실시간 요청을 절대 트리거하지 않아야 하는 워크로드에는 cache_only를 true로 설정하세요.

각 결과에는 콘텐츠를 저장된 사본에서 가져왔는지 실시간으로 가져왔는지, 그리고 언제 가져왔는지가 기록됩니다.

요청에 포함된 URL은 병렬로 가져오며, 각 URL에는 고유한 시간 예산과 상태가 있습니다. 느리거나 손상된 페이지가 하나 있어도 다른 페이지는 실패하지 않습니다. 상태는 각 URL에서 어떤 일이 일어났는지 나타내므로, 에이전트는 시간 초과된 페이지만 다시 시도하고 나머지는 그대로 유지할 수 있습니다.

Context API는 사용 가능한 완전한 콘텐츠를 반환합니다

실제 에이전트 가져오기 요청에서 샘플링한 1,000개의 URL을 대상으로 Context API를 Firecrawl, Exa, Parallel, Keenable, Context.dev와 비교 테스트했습니다. 이 데이터 세트는 715개 사이트를 포괄하며 정부 및 학술 출처와 비영어권 페이지를 포함합니다. 이후 별도의 평가 모델이 각 출력을 어떤 제공업체가 생성했는지 모르는 상태에서 점수를 매겼습니다.

차트는 세 가지 기준으로 성능을 측정합니다.

  • 사용 가능성: 오류 페이지나 빈 결과가 아닌 페이지의 실제 콘텐츠를 반환한 URL의 비율입니다.
  • 사실 재현율: 평가 모델은 모든 제공업체의 결과에서 한 페이지의 핵심 사실을 수집한 다음, 각 출력에 그중 어떤 사실이 포함되어 있는지 확인합니다. 가져오기에 실패하면 0점입니다.
  • 콘텐츠 정밀도: 반환된 텍스트 중 쿠키 알림, 내비게이션, 광고가 아닌 페이지 콘텐츠가 차지하는 비율을 모든 URL에 대해 평균한 값입니다. 가져오기에 실패하면 0점으로 처리됩니다.

이번 평가에서 Context API는 URL의 92.3%에 대해 사용 가능한 콘텐츠를 반환했고, 핵심 사실의 87.9%를 확보했으며, 콘텐츠 정밀도에서 80.3%를 기록했습니다.

가격

Context API 비용은 가져온 URL 1,000개당 $1입니다. 개발자는 ok를 반환한 URL에 대해서만 비용을 지불합니다. 실패한 URL에는 요금이 청구되지 않습니다.

시작하기

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"] }'

각 결과에는 페이지의 Markdown, 쿼리와 일치하는 구절, 페이지 메타데이터, 상태가 함께 반환됩니다. 콘텐츠를 사용하기 전에 각 결과의 상태를 확인하세요.

Context API 문서를 읽거나 API 레퍼런스를 참조하세요.

  1. Orchestrator: 안정적인 추론을 위한 하나의 API개발자2026년 11월 17일
  2. Perplexity의 Monitor API 소개개발자2026년 11월 16일