Web grounding για το Decisions API

Βασίστε τις αποφάσεις σε τρέχοντα δεδομένα του διαδικτύου με το Decisions API του Perplexity. Προσθέστε αναζήτηση σε πραγματικό χρόνο για ακριβείς, ενημερωμένες απαντήσεις.

Web Grounded Decisions API title over an abstract sphere with glowing streams of light.

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

Από σήμερα, το Decisions API του Perplexity μπορεί να κάνει αναζήτηση στο διαδίκτυο πριν απαντήσει.

Προσθέστε μία ρύθμιση, "mode": "web_grounding", σε οποιοδήποτε αίτημα Decisions API και το Perplexity Fast Search εκτελεί ένα ερώτημα για κάθε ερώτηση. Τα αποτελέσματα προστίθενται στο state σας ως στοιχεία, ώστε το μοντέλο αποφάσεων να επιστρέφει πιθανότητες με βάση όσα υπάρχουν στο διαδίκτυο αυτή τη στιγμή. Το state μπορεί επίσης να είναι ένα URL, ώστε να κατευθύνετε το μοντέλο σε μια συγκεκριμένη ιστοσελίδα αντί να εισαγάγετε το κείμενό της.

Στο PWS-Decisions, ένα δημόσιο benchmark με 100 ερωτήσεις που εξαρτώνται από τρέχοντα δεδομένα του διαδικτύου, η ακρίβεια αυξήθηκε από 51% σε 86%, με τυπικούς χρόνους απόκρισης κάτω από 400 ms.

Πώς λειτουργεί ένα μοντέλο αποφάσεων

Ένα μοντέλο αποφάσεων επιστρέφει έναν αριθμό ως απάντηση σε κάθε ερώτηση. Οι χρήστες στέλνουν περιεχόμενο ως state (κείμενο, JSON ή εικόνες) μαζί με μία ή περισσότερες ερωτήσεις. Για μια ερώτηση τύπου noul (ναι ή όχι), το αποτέλεσμα είναι η πιθανότητα του «ναι». Για μια ερώτηση τύπου choice, το αποτέλεσμα είναι μια πιθανότητα για κάθε επιλογή που ορίζει ο χρήστης. Για μια ερώτηση τύπου score, το αποτέλεσμα είναι μια πιθανότητα για κάθε επίπεδο της κλίμακας αξιολόγησής σας και η αναμενόμενη βαθμολογία.

Το μοντέλο έχει δύο πηγές πληροφοριών: το state που στέλνει ένας χρήστης και όσα έμαθε κατά την εκπαίδευσή του. Αυτό αρκεί για μια ερώτηση όπως «Αναφέρει αυτή η κριτική κάποιο ελάττωμα;». Δεν αρκεί για να απαντήσει στο «Είναι αυτό το άτομο ακόμη ο διευθύνων σύμβουλος;». Η απάντηση μπορεί να έχει αλλάξει μετά την εκπαίδευση και τίποτα στο state δεν το αναφέρει. Το web grounding προσθέτει μια τρίτη πηγή: το διαδίκτυο, στο οποίο γίνεται αναζήτηση τη στιγμή του αιτήματος. Το state μπορεί επίσης να είναι ένα URL, ώστε ο χρήστης να κατευθύνει το μοντέλο σε μια ιστοσελίδα αντί για κείμενο.

Πώς λειτουργεί το web grounding

Η γείωση εκτελείται στην πύλη API πριν από την κλήση του μοντέλου. Για κάθε ερώτηση ενός αιτήματος, η πύλη δημιουργεί ένα ερώτημα Fast Search. Τα ερωτήματα εκτελούνται παράλληλα. Η πύλη συγχωνεύει τα αποτελέσματα, αφαιρεί τα διπλότυπα URL και προσαρτά τα τεκμήρια στο state: τίτλο, URL και κείμενο σελίδας. Αν το state είναι URL, το ερώτημα αναζήτησης περιέχει αυτό το URL, ώστε να επιστρέφεται ως τεκμήριο η ίδια η σελίδα και το μοντέλο να απαντά με βάση το κείμενό της. Το μοντέλο επιστρέφει πιθανότητες όπως θα έκανε για οποιοδήποτε αίτημα στο Decisions API. Αν μια αναζήτηση αποτύχει ή λήξει το χρονικό της όριο, το μοντέλο απαντά με όποια τεκμήρια επιστράφηκαν. Η απάντηση περιλαμβάνει το search_results, ώστε ο χρήστης να μπορεί να δει τι είδε το μοντέλο. Το αίτημα του χρήστη και η μορφή της απάντησης παραμένουν ίδια. Αυτό που αλλάζει είναι τα τεκμήρια που έχει το μοντέλο όταν απαντά.

Δοκιμή του web grounding

Στείλαμε 328 ισχυρισμούς τύπου «αληθές ή ψευδές» στο ίδιο μοντέλο αποφάσεων δύο φορές, μία με web grounding και μία χωρίς. Οι ισχυρισμοί μοιράζονταν μεταξύ ειδήσεων του Οκτωβρίου 2026 και σπάνιων γεγονότων από τη Wikipedia, και κάθε αληθής ισχυρισμός είχε ένα ψευδές δίδυμο που διέφερε σε μία λεπτομέρεια. Δεν παρασχέθηκαν στοιχεία στο state.

Χωρίς γείωση στον ιστό, το Decisions API απάντησε σωστά στο 56,4% των ισχυρισμών, κοντά στην τυχαία εικασία. Με γείωση στον ιστό, απάντησε σωστά στο 97,3%, μειώνοντας τα σφάλματα από 143 σε 9. Το αντίτιμο είναι η ταχύτητα: η διάμεση καθυστέρηση αυξήθηκε από 139 ms σε 366 ms και η καθυστέρηση στο 95ο εκατοστημόριο από 514 ms σε 742 ms.

PWS-Decisions

Το PWS-Decisions είναι ένα δημόσιο σύνολο αξιολόγησης με ερωτήσεις κλειστού τύπου σχετικά με την επιλεξιμότητα λογαριασμών, τις δυνατότητες προϊόντων, τους κανόνες πολιτικής και γεγονότα που εξελίσσονται γρήγορα. Οι 100 ερωτήσεις είναι δημόσιες και βαθμολογούνται με ακριβή αντιστοίχιση με μια απάντηση αναφοράς. Τις εκτελέσαμε στο Decisions API + Web Grounding (pplx-decider-v1.2) στις 4 Νοεμβρίου 2026 και απάντησε σωστά σε 86. Τα υπόλοιπα αποτελέσματα παρακάτω προέρχονται από τον δημοσιευμένο πίνακα κατάταξης των δημιουργών του συνόλου αξιολόγησης. Το 51% που καταγράφουν για το Decisions API χωρίς Web Grounding συμπίπτει με τη δική μας εκτέλεση.

Τα αιτήματα Decisions API + Web Grounding επέστρεψαν απόκριση σε 370 ms κατά τη διάμεση τιμή και σε 685 ms στο 95ο εκατοστημόριο, με μέτρηση από το δικό μας πρόγραμμα-πελάτη στις 100 δημόσιες ερωτήσεις. Οι δημιουργοί του benchmark αναφέρουν 560 ms και 710 ms για το δικό τους API στο πλήρες σύνολο των 300 ερωτήσεων, με μέτρηση από το δικό τους πρόγραμμα-πελάτη στις 29 Οκτωβρίου 2026. Σε σύγκριση με τον δημοσιευμένο πίνακα κατάταξης, το Decisions API + Web Grounding έχει την υψηλότερη ακρίβεια στο δημόσιο σύνολο και διάμεσο χρόνο απόκρισης κάτω από 400 ms.

Τι μπορούν να δημιουργήσουν οι προγραμματιστές

Ενεργοποιήστε το web grounding για να απαντάτε σε ερωτήσεις στις οποίες τα δεδομένα δεν μπορούν να απαντήσουν: όταν τα γεγονότα άλλαξαν μετά την εκπαίδευση και έχουν δημοσιευτεί νέες πληροφορίες στο διαδίκτυο. Μερικά παραδείγματα:

  • Αξιολόγηση λογαριασμών βάσει πρόσφατων ειδήσεων. «Άντλησε χρηματοδότηση τις τελευταίες 90 ημέρες;»: σε ολόκληρη μια λίστα λογαριασμών.
  • Παρακολούθηση των εργαλείων από τα οποία εξαρτάστε. «Υπάρχει σταθερή έκδοση νεότερη από την κλειδωμένη έκδοσή μας;»: ελέγχεται βάσει προγράμματος.
  • Επιβεβαίωση πριν ενεργήσει ένας πράκτορας. «Ισχύει ακόμη αυτή η εκδήλωση;»: ελέγχεται πριν από την κράτηση.

Κάθε απάντηση είναι μια πιθανότητα βάσει της οποίας μπορεί να ενεργήσει ο κώδικας ενός προγραμματιστή, μαζί με τις διαδικτυακές πηγές που τη στηρίζουν.

Ξεκινήστε

Προσθέστε το "mode": "web_grounding" σε οποιοδήποτε αίτημα στο Decisions API. Το state μπορεί να είναι κείμενο, όπως ένας ισχυρισμός ή μια εγγραφή, ή ένα URL.

Ελέγξτε έναν ισχυρισμό με βάση τον ιστό:

bash
curl -X POST https://api.perplexity.ai/v1/decisions \ -H "Authorization: Bearer $PERPLEXITY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "pplx-decider-v1.2", "mode": "web_grounding", "state": "Claim: The James Webb Space Telescope launched in December 2021.", "questions": { "supported": { "type": "noul", "instructions": "Is the claim true?" } } }'

Η απάντηση προσθέτει το search_results, δηλαδή τις σελίδες που διάβασε το μοντέλο. Στις 4 Νοεμβρίου, αυτό επέστρεψε πιθανότητα «ναι» πάνω από 0,99, με την καταχώριση της NASA για το διαστημικό σκάφος ως πρώτο αποτέλεσμα.

Υποδείξτε στο μοντέλο μια σελίδα, περνώντας το URL της ως state:

bash
curl -X POST https://api.perplexity.ai/v1/decisions \ -H "Authorization: Bearer $PERPLEXITY_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "pplx-decider-v1.2", "mode": "web_grounding", "state": "https://pypi.org/project/requests/", "questions": { "newer_stable_release": { "type": "noul", "instructions": "Has this package published a stable release newer than 2.31.0 as of today?" } } }'

Στη βιβλιοθήκη Python της Perplexity, περάστε το mode στο σώμα του αιτήματος:

python
from perplexity import Perplexity client = Perplexity() response = client.decisions.create( model="pplx-decider-v1.2", state="Claim: The James Webb Space Telescope launched in December 2021.", questions={"supported": {"type": "noul", "instructions": "Is the claim true?"}}, extra_body={"mode": "web_grounding"}, ) print(response.answers["supported"].noul)

Κάθε ολοκληρωμένη αναζήτηση κοστίζει 0,001 $ επιπλέον των tokens εισόδου. Τα τεκμήρια της αναζήτησης προσμετρώνται στα tokens εισόδου. Ένα αίτημα που χρησιμοποιεί το Web Grounding μπορεί να περιλαμβάνει έως 100 ερωτήσεις.

Ξεκινήστε εξερευνώντας την τεκμηρίωση για τη γείωση στον ιστό.