צ׳אט
כלי ה-harness
מה כל כלי ב-harness עושה, מתי הוא רץ, מה המשמעות של התוצאות ומה המגבלות בצ׳אט, ב-CLI, ב-MCP וב-Research API.
ה-harness הוא אוסף הכלים שמסביב למודלים. בצ׳אט המודל מחליט מתי לקרוא להם, ואפשר לראות כל קריאה עם היעד ומשך הזמן. התוצאות מגיעות למודל עטופות בסמנים עם מזהה אקראי ומסומנות כתוכן לא מהימן.
כלי השרת רק קוראים: דפים ציבוריים, אינדקסי חיפוש, המראות שלנו והקבצים שצירפת. אף אחד מהם לא סורק, לא בודק ולא שולח payload למטרה. סוכן ה-CLI הוא החלק היחיד שמריץ פקודות, על המחשב שלך ובאישורך.
מתי הצ׳אט מציע כל כלי
| כלי | מוצע כש |
|---|---|
web_search, read_url | Web פעיל |
darkweb_search | Web פעיל וההודעה מבקשת זאת במפורש |
cve_lookup, cve_search, advisory_lookup | CVE פעיל |
kb_search, kb_read | תמיד. אין מתג |
file_list, file_read, file_search, binary_info, archive_list, disassemble | יש קובץ מצורף |
הרצה נעצרת אחרי 12 צעדי מודל, 5 קריאות לכלים במקביל, 60 שניות לכלי ו-10 דקות בסך הכל. התוצאות נכנסות לשיחה ומחויבות כטוקני קלט במחיר המודל.
חיפוש ברשת
web_search(query, count?) מקבל שאילתה של עד 400 תווים ומחזיר כותרות, כתובות וקטעים, 5 תוצאות כברירת מחדל ועד 10. תוצאות מ-NVD, cve.org, CISA, GitHub, Seclists, PortSwigger ו-OWASP מדורגות ראשונות, ושאילתות זהות נשמרות במטמון ל-15 דקות. תוצאה יכולה להיות שגויה או ישנה, אז כדאי לפתוח את המקור לפני שסומכים עליה.
קריאת דף
read_url(url) מחזיר את הטקסט של דף ציבורי אחד. בצ׳אט הוא פותח רק כתובות שהקלדת או שחזרו מתוצאת חיפוש, CVE, advisory או בסיס ידע. קישורים בתוך דף ותוצאות .onion לא נפתחים.
הוא מקבל http(s) בפורטים 80 ו-443 ו-HTML, טקסט, JSON או XML, עד 10 MB ו-15 שניות. כל כתובת והפניה נבדקות, החיבור מקובע ל-IP שנבדק ו-robots.txt נשמר. הוא חוסם כתובות IP ישירות, מחרוזות תקיפה, נתיבי קבצים חשופים כמו /.git ו-/.env, ויותר מ-40 נתיבים שונים ב-host אחד ב-10 דקות. גם URL שנושא טקסט מקובץ מצורף נחסם.
חיפוש בדארק ווב
darkweb_search(query, max_results?, engines?) מקבל שאילתה של עד 200 תווים ומחזיר עד 30 רשומות. בלי engines נעשה שימוש בכל האינדקסים.
הצ׳אט מציע את הכלי רק כשמבקשים במפורש. ההודעה צריכה לכלול, באותיות לטיניות, dark web, deep web, darknet, .onion, onion site, hidden service או Tor, או להיות המשך ישיר לתור שכלל אותם. אזכור של קבוצת כופרה או הדלפה לא מספיק, ושאלות כאלה הולכות ל-web_search. כש-Web כבוי, הכלי כבוי.
כל תוצאה היא רשומת אינדקס: כותרת, כתובת .onion, קטע והאינדקס שממנו הגיעה. ה-harness קורא את דפי התוצאות של האינדקסים דרך Tor ולא פותח, סורק או מוריד אף דף שמופיע ברשימה. יש להתייחס לכל רשומה כרמז לא מאומת שעלול להיות עוין.
המגבלה היא 5 חיפושים בדקה למשתמש. תוצאות ממומנות מושמטות. מסנן בטיחות דוחה שאילתות ומשמיט תוצאות על חומרי פגיעה מינית בילדים. בלי נתיב Tor הכלי מדווח על כך ועשוי להשתמש באינדקס אחד ברשת הפתוחה.
ב-MCP, הקריאה ל-darkweb_search היא עצמה הבקשה המפורשת. ל-Research API ול-CLI אין נתיב לדארק ווב.
נתוני CVE
cve_lookup(id) מחזיר רשומה מאוחדת: תיאור מ-NVD, ציון ווקטור CVSS 3.1 או 4.0, CWE, CPE מושפעים עם גרסאות תיקון כשיש ב-NVD, מקורות, ציון ואחוזון EPSS, וסטטוס CISA KEV עם תאריך כניסה ושימוש ידוע בכופרה. כל מקור מציג מתי נמשך. CVE בלי CVSS מוצג כלא מדורג ושום דבר לא מוערך. מזהה שלא קיים במראה נמשך מהמקורות פעם אחת.
cve_search(query?, vendor?, kev?, min_cvss?, min_epss?) מחזיר עד 20 תוצאות מדורגות לפי התאמת טקסט ו-EPSS. הוא פונה ל-NVD במילת מפתח רק כשהמראה לא מוצאת כלום.
Advisories לחבילות
advisory_lookup(name, ecosystem, version?) מחזיר חולשות ידועות מ-OSV, עד 50. הוא מדווח מה ש-OSV מציג לשם ולגרסה האלה. להוכיח שהקוד הפגיע נגיש ב-build שלך זה עליך. ב-MCP הכלי נקרא advisory_query.
בסיס ידע
kb_search(query, domain?, source?, tool?) מחפש בבסיס הידע ו-kb_read(id, from?, limit?) פותח מסמך סעיף אחר סעיף. התחומים הם web, api, mobile, offensive, tools, cloud, ir ו-attack. כל תוצאה נושאת מקור, רישיון וייחוס. טכניקה נישתית אולי לא תהיה שם, והצעד הבא הוא חיפוש ברשת.
קבצים
כלי הקבצים קוראים את מה שהמנתח הסטטי חילץ מקובץ מצורף. שום דבר שהעלית לא מורץ, ואין ניתוח דינמי. כל קובץ מנותח בקונטיינר gVisor חד-פעמי, בלי רשת, עם root לקריאה בלבד ובלי סודות. קובץ שחורג מהמגבלות או כשל של המנתח מסתיימים כ-rejected, עם הסיבה.
| כלי | מחזיר |
|---|---|
file_list | הקבצים המצורפים עם סטטוס, סוג, גודל ואזהרות |
file_read(file_id, from?, limit?) | טקסט שחולץ לפי מקטעים, עם מיקום של קובץ ושורה |
file_search(query) | מקטעים שמכילים את המילים, בכל הקבצים המצורפים |
binary_info(file_id) | SHA-256, גודל, אנטרופיה, ועבור ELF ו-PE גם פורמט, entry point, sections ו-imports |
archive_list(file_id) | האינדקס של הארכיון |
disassemble(file_id) | תצוגה מקדימה: 4 KB הראשונים של הקובץ מפוענחים כ-x86-64, עד 200 פקודות |
אין decompiler ואין גרף זרימה. ארכיונים נעצרים בעומק 3, 10,000 פריטים, 2 GB אחרי פריסה ויחס של 100:1. טקסט נעצר ב-5 מיליון תווים לקובץ. תמונות נותנות מידות בלבד. האזהרה credentials_detected אומרת שהמנתח זיהה תבנית של מפתח או טוקן. סוגי הקבצים מפורטים בקבצים בצ׳אט.
איפה כל כלי זמין
| יכולת | צ׳אט | CLI | MCP | Research API |
|---|---|---|---|---|
| חיפוש ברשת | web_search | agent web_search | web_search | POST /v1/web/search |
| קורא דפים | read_url | read_url | POST /v1/web/read | |
| חיפוש בדארק ווב | darkweb_search | darkweb_search | ||
| רשומת CVE | cve_lookup | notholy cve, agent cve_lookup | cve_lookup | GET /v1/cve/{id} |
| חיפוש CVE | cve_search | notholy cve search | cve_search | GET /v1/cve/search |
| Advisories לחבילות | advisory_lookup | advisory_query | POST /v1/advisories/query | |
| בסיס ידע | kb_search, kb_read | notholy kb, agent kb_search | kb_search, kb_read | GET /v1/kb/search, GET /v1/kb/{id} |
| ניתוח קבצים | כלי הקבצים שלמעלה | notholy analyze | analyze_file | POST /v1/files |
| קבצים מקומיים ופקודות | agent read, grep, glob, edit, write, bash | |||
| סקופ ולוג של engagement | notholy engage |
POST /v1/chat/completions, /v1/responses ו-/v1/messages הם נקודות הקצה הגולמיות של המודלים, ואין בהם כלי harness. המודל מקבל רק את ה-function tools ששלחת, והקוד שלך מריץ אותם. כדי להשתמש בנתונים האלה מהקוד שלך, קוראים ל-Research API או ל-MCP.