ה-Context API מחלץ הקשר מלא מכל דף אינטרנט
השתמשו ב-Perplexity Context API כדי לספק לסוכני AI תוכן Markdown נקי, קישורים וקטעים רלוונטיים מדפי אינטרנט מהמטמון או בזמן אמת.

כשמישהו שואל צ'אטבוט שאלה, ייתכן שסוכן AI יצטרך לקרוא כמה דפי אינטרנט כדי לענות עליה. תוצאות חיפוש רגילות מחזירות לעיתים קרובות קטעים קצרים בלבד. אחזור ישיר של דף עלול להחזיר HTML גולמי, שמלא בתפריטי ניווט, בבאנרים של קובצי Cookie ובפרסומות. סוכנים צריכים את ההקשר של הדף בפורמט שמודל יכול להשתמש בו, ומפתחים צריכים דרך לקבוע עד כמה ההקשר הזה צריך להיות עדכני.
היום אנחנו משיקים את 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 על 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 שנכשלות אין חיוב.
תחילת העבודה
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.