Context API estrae il contesto completo da qualsiasi pagina web
Usa Perplexity Context API per fornire agli agenti IA Markdown pulito, link e passaggi pertinenti da pagine web in cache o in tempo reale.

Quando qualcuno pone una domanda a un chatbot, un agente IA potrebbe dover leggere diverse pagine web per rispondere. I risultati di ricerca standard spesso restituiscono solo degli snippet. Recuperare direttamente una pagina può restituire HTML grezzo, pieno di menu di navigazione, banner dei cookie e pubblicità. Gli agenti hanno bisogno del contesto della pagina in un formato utilizzabile da un modello, mentre gli sviluppatori hanno bisogno di un modo per stabilire quanto debba essere aggiornato quel contesto.
Oggi lanciamo Perplexity Context API, che legge fino a 10 URL e restituisce per ogni pagina markdown pulito, HTML, link e snippet basati sulla query. Le informazioni provengono dal vasto indice web di Perplexity o da un recupero in tempo reale. Gli agenti possono specificare il grado di aggiornamento di ogni richiesta e verificare la fonte di ciascun risultato.
Context API supporta diversi formati
Gli agenti possono avviare una richiesta fornendo un elenco di URL e specificando i formati di output. L’API restituisce un risultato per ogni URL, nello stesso ordine.
Context API supporta diversi formati di risposta:
- Markdown: Il contenuto della pagina in Markdown pulito, pronto da inserire nel contesto di un modello.
- HTML: L’HTML della pagina, per le applicazioni che eseguono un proprio parsing.
- Link: I link presenti nella pagina come URL assoluti, senza duplicati e nell’ordine in cui compaiono, così che un agente possa decidere dove andare dopo.
- Snippet: I passaggi della pagina più pertinenti rispetto alla query fornita, entro il limite di token impostato dallo sviluppatore per ciascuna pagina.
Context API seleziona da ogni pagina i passaggi pertinenti alla query, anziché generare un riassunto. Di conseguenza, il modello riceve il testo originale della pagina, ma solo i passaggi selezionati, quindi c’è meno testo da elaborare.
Ogni risultato riuscito include anche metadati come titolo, descrizione, lingua, autore e data di pubblicazione, oltre ai tag Open Graph della pagina. Per generare il Markdown, Context API suddivide la pagina in blocchi e un modello classifica ciascun blocco come contenuto principale o boilerplate. Vengono mantenuti solo i blocchi di contenuto.
Essenziale per le attività che richiedono il quadro completo
Trovare una pagina pertinente non sempre basta per portare a termine un lavoro. Con Context API, gli agenti possono recuperare dagli URL selezionati i contenuti di cui hanno bisogno per completare attività complesse.
- Implementare un’integrazione API: Un risultato di ricerca può individuare la documentazione giusta senza includere i parametri richiesti, le istruzioni di autenticazione o i casi di errore. Context API può aiutare un agente di programmazione a recuperare la documentazione e i riferimenti API per scrivere un’integrazione basata su questi dettagli.
- Confrontare i prezzi attuali: Un prezzo di listino può dipendere da limiti di utilizzo, condizioni di fatturazione o requisiti di idoneità assenti in un estratto dei risultati di ricerca. Un agente può richiedere il recupero in tempo reale di determinate pagine dei prezzi e leggere tali condizioni prima di effettuare un confronto.
- Rispondere a domande sulle politiche aziendali: Un estratto della politica di reso può indicare il periodo di reso standard ma omettere le eccezioni per determinati prodotti o aree geografiche. Un agente di assistenza può recuperare la pagina della politica, in modo che la sua risposta tenga conto di tali eccezioni.
- Fare ricerca su più fonti: Un estratto dei risultati di ricerca può far emergere una conclusione senza la metodologia, le riserve o l’argomentazione che la accompagna. Un agente di ricerca può recuperare gli articoli e i report selezionati, quindi confrontare le prove anziché basarsi solo sugli estratti.
Controllo dell’aggiornamento e gestione affidabile degli URL
Per impostazione predefinita, Context API verifica innanzitutto se nell’indice web di Perplexity è presente una copia della pagina recuperata negli ultimi due giorni. In caso contrario, recupera la pagina in tempo reale. Gli sviluppatori possono impostare max_age_seconds su 0 per leggere sempre le pagine in tempo reale, ad esempio per prezzi, risultati sportivi e ultime notizie. Per i materiali di riferimento che cambiano raramente, possono aumentarne il valore. Imposta cache_only su true per i carichi di lavoro che non devono mai attivare una richiesta in tempo reale.
Ogni risultato registra se il contenuto proviene da una copia memorizzata o da un recupero in tempo reale, e quando è stato recuperato.
Gli URL di una richiesta vengono recuperati in parallelo, ciascuno con un proprio limite di tempo e un proprio stato. Una pagina lenta o non funzionante non fa fallire le altre. Lo stato indica cosa è successo con ciascun URL, così un agente può riprovare solo le pagine andate in timeout e conservare le altre.
Context API restituisce contenuti utilizzabili e completi
Abbiamo messo a confronto Context API con Firecrawl, Exa, Parallel, Keenable e Context.dev su 1.000 URL campionati da richieste di recupero reali effettuate da agenti. Il campione copre 715 siti e include fonti governative e accademiche e pagine non in inglese. Un modello giudice separato ha poi valutato gli output senza sapere quale provider avesse prodotto ciascuno di essi.
Il grafico misura le prestazioni in base a tre criteri:
- Utilizzabilità: La quota di URL che hanno restituito il contenuto reale della pagina, anziché una pagina di errore o un risultato vuoto.
- Richiamo dei fatti: Il giudice raccoglie i fatti chiave presenti in una pagina considerando tutti i provider, quindi verifica quali di essi sono contenuti in ciascun output. Un recupero non riuscito ottiene un punteggio pari a zero.
- Precisione del contenuto: la percentuale di testo restituito che corrisponde al contenuto della pagina, e non ad avvisi sui cookie, elementi di navigazione o annunci, calcolata come media su tutti gli URL. Un recupero non riuscito ottiene un punteggio pari a zero.
In questa valutazione, la Context API ha restituito contenuti utilizzabili per il 92,3% degli URL, ha recuperato l'87,9% dei fatti chiave e ha ottenuto l'80,3% nella precisione del contenuto.
Prezzi
Context API costa 1 $ ogni 1.000 URL recuperati. Gli sviluppatori pagano per ogni URL che restituisce lo stato ok. Gli URL non riusciti non vengono addebitati.
Per iniziare
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"]
}'Ogni risultato include il Markdown della pagina, i passaggi corrispondenti alla query, i metadati della pagina e uno stato. Controlla lo stato di ciascun risultato prima di utilizzarne il contenuto.
Leggi la documentazione di Context API o consulta il riferimento API.