חיפוש רשת ושליפה
Triggerfish נותן לסוכן שלכם גישה לאינטרנט דרך שני כלים: web_search למציאת מידע ו-web_fetch לקריאת דפי רשת. יחד הם מאפשרים לסוכן לחקור נושאים, לחפש תיעוד, לבדוק אירועים נוכחיים ולשלוף נתונים מהרשת -- הכל תחת אותה אכיפת מדיניות כמו כל כלי אחר.
כלים
web_search
חיפוש ברשת. מחזיר כותרות, כתובות URL ותקצירים.
| פרמטר | סוג | נדרש | תיאור |
|---|---|---|---|
query | string | כן | שאילתת חיפוש. היו ספציפיים -- כללו מילות מפתח רלוונטיות, שמות או תאריכים לתוצאות טובות. |
max_results | number | לא | מקסימום תוצאות להחזרה (ברירת מחדל: 5, מקסימום: 20). |
דוגמת תגובה:
Search results for "deno sqlite module":
1. @db/sqlite - Deno SQLite bindings
https://jsr.io/@db/sqlite
Fast SQLite3 bindings for Deno using FFI...
2. Deno SQLite Guide
https://docs.deno.com/examples/sqlite
How to use SQLite with Deno...web_fetch
שליפה וחילוץ תוכן קריא מכתובת URL. מחזיר טקסט מאמר כברירת מחדל באמצעות Mozilla Readability.
| פרמטר | סוג | נדרש | תיאור |
|---|---|---|---|
url | string | כן | כתובת URL לשליפה. השתמשו בכתובות URL מתוצאות web_search. |
mode | string | לא | מצב חילוץ: readability (ברירת מחדל, טקסט מאמר) או raw (HTML מלא). |
מצבי חילוץ:
readability(ברירת מחדל) -- מחלץ את תוכן המאמר העיקרי, מסיר ניווט, פרסומות ותוכן שבלוני. הטוב ביותר לכתבות חדשות, פוסטים בבלוגים ותיעוד.raw-- מחזיר את ה-HTML המלא. השתמשו כאשר חילוץ readability מחזיר מעט מדי תוכן (למשל, אפליקציות דף יחיד, תוכן דינמי).
כיצד הסוכן משתמש בהם
הסוכן עוקב אחר דפוס חיפוש-ואז-שליפה:
- שימוש ב-
web_searchלמציאת כתובות URL רלוונטיות - שימוש ב-
web_fetchלקריאת הדפים המבטיחים ביותר - סינתזת המידע וציטוט מקורות
בעת תשובה עם מידע מהרשת, הסוכן מצטט כתובות URL מקור בשורה כך שהן נראות בכל הערוצים (Telegram, Slack, CLI, וכו').
תצורה
חיפוש רשת דורש ספק חיפוש. הגדירו אותו ב-triggerfish.yaml:
yaml
web:
search:
provider: brave # ספק חיפוש (brave הוא ברירת המחדל)
api_key: your-api-key # מפתח API של Brave Search| מפתח | סוג | תיאור |
|---|---|---|
web.search.provider | string | ספק חיפוש. נתמך כעת: brave. |
web.search.api_key | string | מפתח API לספק החיפוש. |
אם לא הוגדר ספק חיפוש, web_search מחזיר הודעת שגיאה שאומרת
לסוכן שחיפוש אינו זמין. web_fetch עובד באופן עצמאי -- הוא אינו דורש ספק חיפוש. :::
אבטחה
- כל כתובות URL שנשלפות עוברות מניעת SSRF: DNS מותר תחילה ונבדק מול רשימת חסימת IP קשיחה. טווחי IP פרטיים/שמורים תמיד חסומים.
- תוכן שנשלף מסווג ותורם לזיהום הסשן כמו כל תגובת כלי אחרת.
- וו
PRE_TOOL_CALLמופעל לפני כל שליפה, ו-POST_TOOL_RESPONSEמופעל אחרי, כך שכללי מדיניות מותאמים יכולים להגביל אילו דומיינים הסוכן ניגש אליהם.
