כלים מהירים לשיחה בזמן אמת
בשיחה כל שנייה מורגשת. תכננו כלים עם זמן תגובה קצר, timeout ברור ותוצאה צפויה.
הרעיון המרכזי
כלי מהיר עוקף מסלול תזמור ארוך ומחזיר תשובה מובנית ישירות ל-gateway. בחרו בו רק לפעולה קטנה, צפויה ובעלת latency נמוך.
- קלט קטן
- פלט JSON קצר
- timeout קשיח
- ללא side effect סמוי
Query, Tool או Dispatch
openclaw_query מתאים לשאלה לסוכן; כלי רשום דרך /tools/invoke מתאים לפעולה מהירה ומוגדרת; openclaw_dispatch מתאים לעבודה אסינכרונית שאינה צריכה לעכב את השיחה.
- צריך תשובה מידית מהסוכן: Query
- צריך lookup מהיר: Tool
- צריך עבודה מאוחרת: Dispatch
בחירת transport
לסקריפט מקומי השתמשו ב-bridge manifest שמריץ פקודה עם args מוגבלים. לשירות חיצוני השתמשו ב-HTTPS עם allowlist, אימות ו-timeout.
- אין shell חופשי
- אין URL שהמודל בוחר
- אין secret בתוך manifest
- החזירו exit code ותוצאה ברורים
הוספת כלי בארבעה צעדים
- כתבו סקריפט שמדפיס JSON בלבד
- רשמו אותו ב-manifest עם schema
- בדקו ישירות ללא שיחת קול
- הפעילו ב-config והריצו שיחת Owner
{ "ok": true, "available": ["16:30", "18:00"] }לעטוף במקום לשכתב
כאשר קיימת פקודה אמינה, עטפו אותה במתאם צר במקום להעתיק את הלוגיקה. כך בדיקות, הרשאות ותיקוני באגים נשארים במקור אחד.
- מיפוי args מפורש
- פלט יציב
- שגיאה מובנית
- בדיקת תאימות בגרסה
קריאה מהירה, כתיבה מיוחדת
Lookup יכול להיות אוטומטי. כתיבה שמשנה יומן, CRM או תשלום דורשת confirmation, idempotency ו-audit. מהירות אינה סיבה להחליש את הבקרות.
- אישור בקול
- idempotency key
- tenant check
- תוצאה מאומתת לפני אישור ללקוח
תקלות נפוצות
- not_found: בדקו שם כלי וטעינת manifest
- קלט ריק: בדקו התאמת schema ל-args
- כלי איטי: מדדו את הסקריפט בלי קול
- מידע גדול: החזירו רק שדות שנדרשים לתשובה
- כלי לא נתמך: ודאו גרסת gateway
בדיקת בטיחות
ב-timeout מחזירים כשל מובנה ומסלול חלופי, לא תוצאה משוערת.