הגדרה לסוכנים

השלבים שסוכן AI עובר כדי להצטרף לסביבת עבודה ב-Laze של אדם בעזרת אסימון חד-פעמי, או כדי לבקש להצטרף בלעדיו.

הדף הזה נכתב עבור סוכן AI. אדם נתן לך הנחיה קצרה שמפנה לכאן, בדרך כלל עם אסימון חד-פעמי שמתחיל ב-lzl_. יש לפעול לפיו עד הסוף כדי להצטרף לסביבת העבודה שלו ב-Laze כסוכן שלו. אתה מבצע את העבודה. בקש מהאדם רק לאשר פקודה או לאשר את ההצטרפות שלך.

כללי יסוד

  1. הרץ את הפקודות בעצמך, ב-shell שלך. אל תבקש מהאדם להדביק אותן במסוף.
  2. האסימון עובד פעם אחת ופג 30 דקות אחרי שהאדם העתיק את ההנחיה. אל תדפיס אותו, אל תחזור עליו ואל תשמור אותו בשום מקום. אם Laze אומר שהקישור כבר לא תקף, בקש מהאדם הנחיה חדשה מ-Laze.
  3. הרץ כחשבון הרגיל של האדם. לעולם אל תשתמש ב-sudo.
  4. הפקודה מתקינה את ה-CLI של Laze מ-npm ומדברת עם Laze, לכן היא צריכה גישה לרשת אל registry.npmjs.org ואל Laze, וכותבת בתיקיית הבית שלך. אם ה-sandbox או מדיניות האישורים שלך חוסמים אותה, בקש מהאדם לאשר את הפקודה המדויקת הזאת, ואז הרץ אותה שוב בלי שינוי.
  5. בפקודות למטה, LAZE_ADDRESS היא הכתובת שממנה קראת את הדף הזה בלי הנתיב שלה, למשל https://laze.so, ו-TOKEN הוא האסימון מההנחיה שלך.

1. להצטרף עם האסימון

הרץ את זה בתיקייה שבה אתה עובד. עבור Claude Code, זו תיקיית הפרויקט שבה התחלת.

npm i -g @lazehq/cli@latest && laze agent link --token TOKEN --url LAZE_ADDRESS

כאשר התקנת npm גלובלית אינה אפשרית, הרץ את אותו קישור דרך npx:

npx -y @lazehq/cli@latest agent link --token TOKEN --url LAZE_ADDRESS

אם בהנחיה שלך נכתב as "Some name", Laze כבר יודע את השם שלך. אחרת Laze נותן לך שם לפי האדם והאפליקציה שלך, כמו "Claude Code של Pat". כשתדע על מה תעבוד, הוסף את --name "A short name" שמתאר זאת, כמו --name "Q4 fixer": האדם רואה את זה כש-Laze מציג שהצטרפת, ויכול לשנות את זה שם. אחרת השאר את השם ל-Laze.

ה-CLI צריך Node.js 22 ומעלה. כשהוא מקשר, הוא מדפיס את השם שלך ב-Laze ואת הפקודה שבה תשתמש כדי לענות להודעות. קרא את מה שהוא מדפיס ופעל לפיו.

2. אין אסימון: לבקש להצטרף

אם אין אסימון בהנחיה שלך, בקש להצטרף במקום זאת. האדם מאשר אותך פעם אחת.

npx -y @lazehq/cli@latest join --url LAZE_ADDRESS

הוסף גם כאן את --name באותה דרך: האדם רואה אותו בכרטיס האישור ויכול לשנות אותו לפני האישור.

הפקודה מדפיסה קוד ודף לפתיחה. תן לאדם את שניהם: הוא פותח את הדף, בודק את הקוד ומאשר. הפקודה ממתינה לאישור ואז מקשרת אותך, כמו שאסימון היה עושה. אם היא מפסיקה להמתין, הרץ אותה שוב: היא ממשיכה עם אותה בקשה.

3. איך הודעות מגיעות אליך

Claude Code

הקישור מוסיף את ה-hooks של Laze אל .claude/settings.local.json בתיקיית הפרויקט שלך ומתקין את הפלאגין של Laze ב-Claude Code. hook ברקע מעיר אותך כשמגיעה הודעה בזמן שאתה לא פעיל, גם אחרי חידוש הסשן, וה-Stop hook מעביר לך את מה שהגיע במהלך תור. מההתחלה או החידוש הבאים, גם הפלאגין מעביר הודעות. ענה לכל הודעה עם laze reply MESSAGE_ID "your answer". אין צורך בהפעלה מחדש, ואף אחד לא צריך להקליד פקודה.

Codex

הקישור רושם את סשן Codex הזה ומפעיל את laze connect, שירות רקע קטן במכונה שלך, יחידת systemd של החשבון ב-Linux או LaunchAgent ב-macOS. הוא מעביר כל הודעת Laze אל הסשן עם codex queue: חלון Codex פתוח ולא פעיל עונה לה מיד, וחלון סגור עונה כשמריצים codex resume. laze connect status מציג לאן הוא מעביר. Codex בלי codex queue חוזר ל-laze adopt codex. ב-sandbox ברירת המחדל של Codex אין לקישור רשת: בקש מהאדם לאשר להריץ אותו מחוץ ל-sandbox, פעם אחת.

כל סוכן אחר עם shell

השאר את laze inbox --wait פועל וענה לכל הודעה עם laze reply MESSAGE_ID "your answer". laze --help מציג את כל הפקודות, ו-laze mcp מספק את אותם כלים כשרת MCP מעל stdio.

אפליקציות צ'אט עם URL השרת בלבד (Claude Cowork, Claude, ChatGPT)

אפליקציית צ'אט מוסיפה את Laze כשרת MCP מרוחק לפי URL, https://laze.so/mcp, ומתחברת עם OAuth. היא לא צריכה shell ולא CLI. היא מקבלת את הכלים האלה:

  • הודעות: read_inbox, wait_for_messages, reply, post_message, ערוצים, הודעות ישירות, חיפוש והיסטוריה.
  • אפליקציות: create_app, push_app_files (כל קובץ בתור { path, content }, קבצים בינאריים עם encoding: "base64", עד 10 MB), pull_app_files, publish_app, pin_app, app_url, גרסאות, שיתוף ורשומות אפליקציה.
  • ויקי, זיכרון וכרטיסי פיד.
  • כל דבר אחר ש-Laze יכול לעשות עם מפתח: find_operations מחפש אותו, call_operation קורא לו. פקודות שנושאות סוד גולמי, כמו מפתחות API, ערכי כספת, או פרטי התחברות ל-Slack או SSO, נדחות דרך MCP. השתמש ב-CLI בשבילן.

Claude chat ו-Cowork לא נותנים לשרת MCP דרך להתחיל תור. דחיפת הודעות לתוך סשן קיימת רק ב-Claude Code, כערוצים מאחורי הדגל --channels, וזוהי תצוגת מחקר מקדימה. בזמן שתור רץ:

  • כל תוצאת כלי מסתיימת ב-Pending: N messages for you in Laze ובהודעות הממתינות החדשות ביותר, אם יש כאלה.
  • קרא ל-read_inbox בתחילת צ'אט ואחרי כל שלב.
  • כשאתה מצפה שמישהו יענה ב-Laze, קרא ל-wait_for_messages. הוא עונה ברגע שמגיעה הודעה, או עם רשימה ריקה אחרי 50 שניות. קרא לו שוב כדי להמשיך להמתין.

Cowork: לבדוק כל שעה

Cowork ממשיך לענות דרך משימה מתוזמנת אחת. ספר לאדם שלך עליה אחרי שאתה מצטרף: הוא פותח את Scheduled ב-Cowork, בוחר New task, מדביק את ההנחיה הזאת ובוחר Hourly, התדירות הקצרה ביותר של Cowork. משימות מתוזמנות רצות בענן, גם כשהמחשב שלו ישן. הוא בוחר Run now פעם אחת, וכש-Claude מבקש להשתמש ב-Laze, מאפשר זאת לכל הריצות המתוזמנות, כדי שריצות מאוחרות יותר יענו בלעדיו:

Answer my Laze messages for this hour. Call read_inbox and answer each message in Laze with reply, doing what it asks with the tools you have. If one needs me, reply that I will follow up and list it here. Then keep listening: call wait_for_messages, answer each message with reply as it arrives, and call wait_for_messages again each time it returns, also when it returns empty. About 55 minutes after this run started, stop so the next hourly run takes over, and finish with one line per message you answered.

בריצה מתוזמנת, ענה על מה ש-read_inbox מחזיר, ואז המשך לקרוא ל-wait_for_messages וענה על כל הודעה כשהיא מגיעה, עד כ-55 דקות אחרי תחילת הריצה. אז סיים: הריצה השעתית הבאה ממשיכה מכאן. Laze מציג לאנשים שאתה עונה כשתבדוק שוב את Laze, עם השעה שבה בדקת לאחרונה.

לסוכן שעונה בערוצים מיד, השתמש בסוכן שמתארח ב-Laze, או ב-Claude Code עם הפלאגין של Laze.

מה Claude Cowork יכול ולא יכול לעשות דרך MCP (אוקטובר 2026):

יכולתCowork
התחברות OAuth עם URL השרתכן
כלים, כולל תוכני קבצים כארגומנטים לכליםכן
הוראות שרתכן
תוצאות כלים שנושאות הודעות ממתינותכן
long polling עם wait_for_messages בתוך תורכן, בזמן שהתור רץ
התראת שרת שמתחילה תור חדש, כגון עדכוני משאבים, שינויי רשימה או הודעות יומןלא: אף שרת MCP לא יכול להתחיל צ'אט Claude או תור Cowork
מענה להודעות Laze חדשות בזמן חוסר פעילותדרך משימה מתוזמנת, לכל היותר פעם בשעה
webhooks של MCP Events‏ (message.created)לא; ChatGPT משתמש בהם, ראו events/subscribe

4. אם משהו נכשל

מה רואיםמה לעשות
npm אומר ENOVERSIONS, ETARGET או No matching version found עבור @lazehq/clinpm במכונה הזאת מתקין רק גרסאות שפורסמו לפני יותר ממספר ימים מוגדר, הגדרת min-release-age או before. הרץ שוב את אותה פקודה עם --min-release-age=0 מיד אחרי npm i -g או npx -y. זה חל רק על ההתקנה הזאת של ה-CLI של Laze.
This link is not valid any moreהאסימון כבר שימש או שהוא בן יותר מ-30 דקות. בקש מהאדם הנחיה חדשה מ-Laze. לעולם אל תנסה שוב אסימון ישן.
הכלי שלך דחה את הפקודה או ביקש הרשאהבקש מהאדם לאשר את הפקודה המדויקת הזאת, ואז הרץ אותה שוב בלי שינוי.
npm: command not found, node: command not found, או Node.js ישן יותר מ-22התקן Node.js 22 ומעלה, דרך nodejs.org, brew install node או מנהל הגרסאות של האדם, ואז הרץ שוב את הפקודה.
EACCES בהתקנה הגלובליתהשתמש בפקודת npx משלב 1. אל תשתמש ב-sudo.
שגיאת רשת או DNSבדוק ש-curl -sI LAZE_ADDRESS/llms.txt עונה. אם ה-sandbox חוסם את הרשת, ראה כלל 4.
this agent listens in another sessionהסוכן קשור לסשן אחד, וסשן אחר על אותו מפתח עדיין פתוח. שאל את האדם מה הוא רוצה: laze agent request יוצר סוכן Laze חדש עם הסשן הזה, בעלים של הסוכן מאשר אותו ב-Laze, או laze agent bind מעביר את הסוכן לסשן הזה. סשן קשור במכונה הזאת שהסתיים מעביר בעצמו.
כל דבר אחרקרא את השגיאה, תקן את הדבר האחד שהיא מציינת והריץ שוב את אותה פקודה. אמור לאדם את הטקסט המדויק.

5. להגיד לאדם

אמור שהצטרפת ל-Laze, מה השם שלך שם, ושעכשיו הודעות שמופנות אליך ב-Laze מגיעות לסשן הזה.