בטא בקרוב. הפיצ׳ר עדיין בפיתוח, ולכן שמות ופרטים עשויים להשתנות לפני השחרור.

קריאות כלים של Rex והתחברות עם Slack

‏Rex, הסוכן של Zaprex, משתמש באפליקציות המחוברות שלכם: הוא קורא לכלי ה-MCP שלהן, מציג כל קריאה בצ'אט ושואל לפני כל דבר שהוא שולח. ‏Sign in with Slack מאפשר ל-Rex לשלוח הודעות ישירות ולפרסם בערוצים, עם Approve,‏ Edit או Cancel על כל הודעה.

כרטיס אישור של Rex ב-Zaprex: ‏Slack slack_send_message,‏ To @ana,‏ Message the build is green,‏ Nothing is sent until you approve, עם Cancel,‏ Edit ו-Approveכרטיס אישור של Rex ב-Zaprex: ‏Slack slack_send_message,‏ To @ana,‏ Message the build is green,‏ Nothing is sent until you approve, עם Cancel,‏ Edit ו-Approve
כרטיס אישור של Rex ב-Zaprex: ‏Slack slack_send_message,‏ To @ana,‏ Message the build is green,‏ Nothing is sent until you approve, עם Cancel,‏ Edit ו-Approve

הפעלת Slack

‏Slack כבוי עד שמפעילים אותו. כל אחת מהדרכים האלה מפעילה אותו, באפליקציות Zaprex לרשת, למחשב ולטלפון:

  • בצ'אט: הזכירו את Slack או בקשו מ-Rex לכתוב למישהו (פרסם את הערות הגרסה ב-Slack, DM @ana that the build is green). מתחת לתשובה מופיעה שורה עם Turn on Slack ו-×. ‏Turn on Slack מפעיל אותו ופותח את Sign in with Slack. ‏**×** מסתיר אותה לתמיד.
  • סרגל הכלים: הלוגו של Slack ליד הדמות של Rex. כשהוא כבוי, לחיצה אחת מפעילה את Slack ומתחילה את ההתחברות.
  • הגדרות › Features: ל-Slack (Connected apps) יש מתג הפעלה ו-Turn on and sign in.
  • לוח הפקודות: ‏⌘K (‏Ctrl+K), ואז Connect Slack.

הפעלת Slack מפעילה גם את Connect apps; כיבוי Connect apps מכבה את Slack. כדי להפסיק הצעות בצ'אט לכל התכונות וההרחבות, כבו את Suggest extensions in chat בהגדרות.

הצעה בשורה אחת מתחת לתשובה של Zaprex עם הלוגו של Slack: ‏Rex can send Slack messages for you, and shows you each one before it goes out, עם Turn on Slack ו-×הצעה בשורה אחת מתחת לתשובה של Zaprex עם הלוגו של Slack: ‏Rex can send Slack messages for you, and shows you each one before it goes out, עם Turn on Slack ו-×
הצעה בשורה אחת מתחת לתשובה של Zaprex עם הלוגו של Slack: ‏Rex can send Slack messages for you, and shows you each one before it goes out, עם Turn on Slack ו-×
הגדרות Zaprex › Features: ‏MCP servers (Connect apps) מופעל עם Run read-only app tools without asking,‏ Git accounts ו-Slack (Connected apps) עם Turn on and sign inהגדרות Zaprex › Features: ‏MCP servers (Connect apps) מופעל עם Run read-only app tools without asking,‏ Git accounts ו-Slack (Connected apps) עם Turn on and sign in
הגדרות Zaprex › Features: ‏MCP servers (Connect apps) מופעל עם Run read-only app tools without asking,‏ Git accounts ו-Slack (Connected apps) עם Turn on and sign in

התחברות עם Slack

‏Sign in with Slack פותח את הדף של Slack עצמו, שבו בוחרים את סביבת העבודה ומאשרים את Rex. ‏Rex מבקש את ההרשאות האלה, גם לבוט וגם לכם: ‏chat:write,‏ im:write,‏ channels:read ו-users:read.

כשחוזרים, Connect apps נפתח על Slack עם סביבת העבודה שהתחברתם אליה והכלים שלה: שליחת הודעה מסומנת asks first, וכלי הרשימות reads. הטוקנים נשמרים מוצפנים בשרת ולא נשלחים לאפליקציה. באפליקציות למחשב ולטלפון ההתחברות נפתחת בדפדפן וחוזרת לאפליקציה דרך zaprex://app?connect=apps&signed_in=slack.

‏Sign in again מחדש את ההתחברות, ו-Disconnect מוחק את הטוקנים.

‏Slack ב-Connect apps: ‏Connected עם 3 כלים, Signed in to Fake Workspace, ההרשאות chat:write,‏ im:write,‏ channels:read ו-users:read, והכלים slack_list_channels,‏ slack_list_users ו-slack_send_message‏Slack ב-Connect apps: ‏Connected עם 3 כלים, Signed in to Fake Workspace, ההרשאות chat:write,‏ im:write,‏ channels:read ו-users:read, והכלים slack_list_channels,‏ slack_list_users ו-slack_send_message
‏Slack ב-Connect apps: ‏Connected עם 3 כלים, Signed in to Fake Workspace, ההרשאות chat:write,‏ im:write,‏ channels:read ו-users:read, והכלים slack_list_channels,‏ slack_list_users ו-slack_send_message

אישור, עריכה או ביטול

כל מה ששולח, מפרסם, יוצר או מוחק מחכה לכם. הכרטיס מציג:

  • ‏To: בדיוק למי זה הולך, כמו @ana או #releases.
  • ‏Message: הטקסט המדויק.
  • ‏Approve (‏Enter) שולח פעם אחת. ‏Rex ישאל שוב בפעם הבאה.
  • ‏Edit משנה את הנמען ואת הטקסט (או, בכלים אחרים, את הארגומנטים כ-JSON), ואז Send edited.
  • ‏Cancel (‏Esc) לא שולח כלום, ו-Rex אומר את זה בצ'אט.
עריכת הודעת Slack לפני שליחה: שדה To עם #general, ה-Message ‏Release 2.1 is out, עם Back ו-Send editedעריכת הודעת Slack לפני שליחה: שדה To עם #general, ה-Message ‏Release 2.1 is out, עם Back ו-Send edited
עריכת הודעת Slack לפני שליחה: שדה To עם #general, ה-Message ‏Release 2.1 is out, עם Back ו-Send edited

אחר כך כל קריאה מופיעה בצ'אט ככרטיס עם הלוגו של האפליקציה, הכלי, הארגומנטים שלו והתוצאה.

כרטיס כלי בצ'אט: ‏Slack slack_send_message,‏ Sent, הארגומנטים channel_id @ana ו-text, והתוצאה Sent to @ana: the build is greenכרטיס כלי בצ'אט: ‏Slack slack_send_message,‏ Sent, הארגומנטים channel_id @ana ו-text, והתוצאה Sent to @ana: the build is green
כרטיס כלי בצ'אט: ‏Slack slack_send_message,‏ Sent, הארגומנטים channel_id @ana ו-text, והתוצאה Sent to @ana: the build is green

אם האפליקציה מחזירה שגיאה, כמו channel_not_found, הכרטיס מציג אותה באדום ושום דבר לא נשלח.

כרטיס כלי שנכשל: ‏Slack slack_send_message,‏ Failed, והשגיאה channel_not_found: @zedכרטיס כלי שנכשל: ‏Slack slack_send_message,‏ Failed, והשגיאה channel_not_found: @zed
כרטיס כלי שנכשל: ‏Slack slack_send_message,‏ Failed, והשגיאה channel_not_found: @zed

כלים לקריאה בלבד

כלים שרק קוראים (רשימת ערוצים, חיפוש אנשים, קריאת issue) רצים בלי לשאול כברירת מחדל. כדי לאשר גם אותם, כבו את Run read-only app tools without asking תחת הגדרות › Features › MCP servers (Connect apps). פעולות כתיבה תמיד שואלות, לא משנה מה ההגדרה.

אפליקציות אחרות ושרתי MCP משלכם

כל שרת MCP מחובר עובד אותו דבר: ‏Rex רואה את הכלים שלו ואת ההוראות שלכם, קורא להם ושואל לפני כל כתיבה. ב-Connect apps, ‏**+ Add custom MCP** מוסיף שרת לפי כתובת (‏Streamable HTTP או HTTP + SSE) בלי התחברות, עם טוקן, header משלכם או התחברות OAuth, או כפקודה מקומית (‏stdio) בשרתים באירוח עצמי. ‏Test connection מציג את מספר הכלים, או סיבה ברורה, לפני השמירה.

הוספת שרת MCP משלכם: השם Team chat,‏ Streamable HTTP, כתובת השרת, Access token ו-Test connection שמציג Connected · 3 toolsהוספת שרת MCP משלכם: השם Team chat,‏ Streamable HTTP, כתובת השרת, Access token ו-Test connection שמציג Connected · 3 tools
הוספת שרת MCP משלכם: השם Team chat,‏ Streamable HTTP, כתובת השרת, Access token ו-Test connection שמציג Connected · 3 tools

בטלפון

כרטיס האישור נכנס במסך, ו-Approve,‏ Edit ו-Cancel במרחק נגיעה. ‏Sign in with Slack נפתח בחלון הדפדפן של המערכת ונסגר לבד כשחוזרים.

‏Zaprex בטלפון: כרטיס האישור של Slack עם To @ana וההודעה on my way, עם Cancel,‏ Edit ו-Approve‏Zaprex בטלפון: כרטיס האישור של Slack עם To @ana וההודעה on my way, עם Cancel,‏ Edit ו-Approve
‏Zaprex בטלפון: כרטיס האישור של Slack עם To @ana וההודעה on my way, עם Cancel,‏ Edit ו-Approve

מגבלות

אישור אחד לכל כתיבה: ‏Rex אף פעם לא זוכר "לאשר תמיד" לשליחה. עד 5 קריאות כלים בהרצה; כל אחת מחכה עד 30 שניות, ו-Rex שומר את 4,000 התווים הראשונים של התוצאה. שרתי פקודה מקומית (‏stdio) רצים רק בשרתי Zaprex באירוח עצמי שמפעילים אותם.

הגדרות

הגדרהברירת מחדלמה היא עושה
Slack (Connected apps)כבוימציג את כפתור Slack בסרגל הכלים ומאפשר Sign in with Slack. ההפעלה מפעילה גם את Connect apps.
Run read-only app tools without askingמופעלכלים לקריאה בלבד רצים מיד; כשכבוי, גם הם שואלים. כל מה שכותב תמיד שואל.
Suggest extensions in chatמופעלמציג את ההצעה בשורה אחת (‏Turn on Slack) כשהודעה מזכירה את Slack או שליחת הודעה למישהו. הצעה שנסגרה לא חוזרת.

שרתים באירוח עצמי מגדירים את משתני הסביבה האלה: ‏SLACK_CLIENT_ID ו-SLACK_CLIENT_SECRET (אפליקציית Slack שלכם; בלעדיהם Sign in with Slack אומר שהוא לא מוגדר), ‏SLACK_MCP_URL (שרת ה-MCP של Slack ש-Rex קורא לו), ‏BOT_MCP_STDIO=on (מאפשר שרתי פקודה מקומית) ו-BOT_MCP_ALLOW_PRIVATE=on (מאפשר כתובות פרטיות ו-localhost, לפיתוח בלבד).

ההגדרות האלה מופיעות גם במדריך ההגדרות.

למפתחים

‏POST /api/bot/chat מתחיל הרצה שיכולה לקרוא לכלים. ‏GET /api/bot/approvals מציג את האישורים; לאישור של קריאת כלי יש call עם השרת, הכלי, הארגומנטים, recipient ו-text. ‏POST /api/bot/approvals/:id מקבל decision וגם args כדי לשלוח קריאה ערוכה. ‏Sign in with Slack: ‏GET /api/bot/slack/status ו-POST /api/bot/slack/connect; ‏OAuth חוזר דרך /api/bot/oauth/callback. בדקו שרת לפני שמירה עם POST /api/bot/mcp/servers/test. ראו API › קריאות כלים של Rex.

פתרון בעיות

  • ‏Sign in with Slack isn't set up: לשרת Zaprex עדיין אין אפליקציית Slack. מנהל מוסיף SLACK_CLIENT_ID ו-SLACK_CLIENT_SECRET.
  • ‏You cancelled the sign-in: לחצו שוב Sign in with Slack ואשרו את Rex.
  • ‏**channel_not_found: הערוץ או האדם לא קיימים, או ש-Rex לא נמצא בערוץ. ‏Edit** את הנמען ושלחו שוב.
  • ‏Rex ענה במקום לשלוח: כתבו למי לשלוח ומה, למשל DM @ana on Slack: the build is green.

Beta קריאות כלים ו-Sign in with Slack נמצאים בבטא. ספרו לנו באילו אפליקציות Rex צריך להשתמש בהמשך בדף התמיכה.

ראו גם Rex tool calls בתיעוד של Zaprex ו-Slack עבור Ingot IDE.