Το Context API εξάγει το πλήρες πλαίσιο από οποιαδήποτε ιστοσελίδα

Χρησιμοποιήστε το Perplexity Context API για να παρέχετε στους πράκτορες AI καθαρό Markdown, συνδέσμους και σχετικά τμήματα κειμένου από αποθηκευμένες στην κρυφή μνήμη ή ζωντανές ιστοσελίδες.

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

Όταν κάποιος κάνει μια ερώτηση σε ένα chatbot, ένας πράκτορας AI μπορεί να χρειαστεί να διαβάσει αρκετές ιστοσελίδες για να απαντήσει. Τα συνήθη αποτελέσματα αναζήτησης συχνά επιστρέφουν μόνο αποσπάσματα. Η απευθείας ανάκτηση μιας σελίδας μπορεί να επιστρέψει ακατέργαστο HTML, γεμάτο στοιχεία πλοήγησης, banner για cookie και διαφημίσεις. Οι πράκτορες χρειάζονται το περιεχόμενο της σελίδας σε μορφή που μπορεί να αξιοποιήσει ένα μοντέλο ως πλαίσιο, ενώ οι προγραμματιστές χρειάζονται έναν τρόπο να ελέγχουν πόσο πρόσφατο πρέπει να είναι αυτό το περιεχόμενο.

Σήμερα παρουσιάζουμε το Perplexity Context API, το οποίο διαβάζει έως 10 URL και επιστρέφει για κάθε σελίδα καθαρό markdown, HTML, συνδέσμους και αποσπάσματα βάσει ερωτήματος. Οι πληροφορίες προέρχονται από το τεράστιο ευρετήριο ιστού της Perplexity ή από ζωντανή ανάκτηση. Οι πράκτορες μπορούν να καθορίζουν πόσο πρόσφατο πρέπει να είναι το περιεχόμενο κάθε αιτήματος και να επαληθεύουν την πηγή κάθε αποτελέσματος.

Το Context API υποστηρίζει ποικιλία μορφών

Οι πράκτορες μπορούν να υποβάλουν ένα αίτημα παρέχοντας μια λίστα με URL και καθορίζοντας τις μορφές εξόδου. Το API επιστρέφει ένα αποτέλεσμα για κάθε URL με την ίδια σειρά.

Το Context API υποστηρίζει ποικιλία μορφών απόκρισης:

  • Markdown: Το περιεχόμενο της σελίδας σε καθαρό Markdown, έτοιμο να τοποθετηθεί στο πλαίσιο ενός μοντέλου.
  • HTML: Ο κώδικας HTML της σελίδας, για εφαρμογές που εκτελούν τη δική τους ανάλυση.
  • Σύνδεσμοι: Οι σύνδεσμοι της σελίδας ως απόλυτα URL, χωρίς διπλότυπα και με τη σειρά που εμφανίζονται στη σελίδα, ώστε ένας πράκτορας να μπορεί να αποφασίσει πού θα πάει στη συνέχεια.
  • Αποσπάσματα: Τα τμήματα της σελίδας που σχετίζονται περισσότερο με ένα δεδομένο ερώτημα, εντός του ορίου token που ορίζει ο προγραμματιστής για κάθε σελίδα.

Το Context API επιλέγει από κάθε σελίδα τα τμήματα που σχετίζονται με το ερώτημα, αντί να δημιουργεί περίληψη. Έτσι, το μοντέλο λαμβάνει την αυθεντική διατύπωση της σελίδας, αλλά μόνο τα επιλεγμένα τμήματα, οπότε έχει λιγότερο κείμενο προς επεξεργασία.

Κάθε επιτυχές αποτέλεσμα περιλαμβάνει επίσης μεταδεδομένα, όπως τον τίτλο, την περιγραφή, τη γλώσσα, τον συντάκτη και την ημερομηνία δημοσίευσης, καθώς και τις ετικέτες Open Graph της σελίδας. Για να δημιουργήσει το Markdown, το Context API χωρίζει τη σελίδα σε μπλοκ και ένα μοντέλο αξιολογεί κάθε μπλοκ ως κύριο περιεχόμενο ή τυποποιημένο περιεχόμενο (boilerplate). Διατηρούνται μόνο τα μπλοκ περιεχομένου.

Απαραίτητο για εργασίες που απαιτούν την πλήρη εικόνα

Ο εντοπισμός μιας σχετικής σελίδας δεν αρκεί πάντα για να ολοκληρωθεί μια εργασία. Με το 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 σε 1.000 URL που επιλέχθηκαν δειγματοληπτικά από πραγματικά αιτήματα ανάκτησης πρακτόρων. Το σύνολο καλύπτει 715 ιστότοπους και περιλαμβάνει κυβερνητικές και ακαδημαϊκές πηγές, καθώς και σελίδες σε γλώσσες εκτός των αγγλικών. Στη συνέχεια, ένα ξεχωριστό μοντέλο-κριτής βαθμολόγησε τα αποτελέσματα χωρίς να γνωρίζει ποιος πάροχος είχε παραγάγει το καθένα.

Το γράφημα μετρά την απόδοση με βάση τρία κριτήρια:

  • Αξιοποιήσιμο: Το ποσοστό των URL που επέστρεψαν το πραγματικό περιεχόμενο της σελίδας και όχι σελίδα σφάλματος ή κενό αποτέλεσμα.
  • Ανάκληση στοιχείων: Ο κριτής συγκεντρώνει τα βασικά στοιχεία που εντοπίζονται σε μια σελίδα από όλους τους παρόχους και στη συνέχεια ελέγχει ποια από αυτά περιέχει κάθε αποτέλεσμα. Μια αποτυχημένη ανάκτηση βαθμολογείται με μηδέν.
  • Ακρίβεια περιεχομένου: Το ποσοστό του επιστρεφόμενου κειμένου που αποτελεί περιεχόμενο της σελίδας και όχι ειδοποιήσεις cookie, στοιχεία πλοήγησης ή διαφημίσεις, κατά μέσο όρο σε όλα τα URL. Μια αποτυχημένη ανάκτηση βαθμολογείται με μηδέν.

Σε αυτή την αξιολόγηση, το Context API επέστρεψε αξιοποιήσιμο περιεχόμενο για το 92,3% των URL, ανέκτησε το 87,9% των βασικών στοιχείων και σημείωσε 80,3% στην ακρίβεια περιεχομένου.

Τιμολόγηση

Το Context API κοστίζει 1 $ ανά 1.000 URL που ανακτώνται. Οι προγραμματιστές πληρώνουν για κάθε URL που επιστρέφει ok. Τα 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 για αξιόπιστο συμπερασμόΠρογραμματιστές17 Νοε 2026
  2. Παρουσιάζουμε το Monitor API της PerplexityΠρογραμματιστές16 Νοε 2026