Telegram

חברו את סוכן ה-Triggerfish שלכם ל-Telegram כדי שתוכלו לתקשר איתו מכל מכשיר שבו אתם משתמשים ב-Telegram. המתאם משתמש בפריימוורק grammY לתקשורת עם Telegram Bot API.

הגדרה

שלב 1: יצירת בוט

1. פתחו את Telegram וחפשו @BotFather
2. שלחו /newbot
3. בחרו שם תצוגה לבוט (למשל, "My Triggerfish")
4. בחרו שם משתמש לבוט (חייב להסתיים ב-bot, למשל, my_triggerfish_bot)
5. BotFather ישיב עם טוקן הבוט -- העתיקו אותו

שמרו על הטוקן בסוד טוקן הבוט מעניק שליטה מלאה על הבוט.

לעולם אל תכניסו אותו לניהול גרסאות או תשתפו אותו בפומבי. Triggerfish מאחסן אותו ב-OS keychain. :::

שלב 2: קבלת מזהה המשתמש שלכם ב-Telegram

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

1. חפשו @getmyid_bot ב-Telegram
2. שלחו לו הודעה כלשהי
3. הוא ישיב עם מזהה המשתמש שלכם (מספר כמו 8019881968)

שלב 3: הוספת הערוץ

הריצו את ההגדרה האינטראקטיבית:

triggerfish config add-channel telegram

זה מבקש את טוקן הבוט, מזהה המשתמש ורמת הסיווג, ואז כותב את התצורה ל-triggerfish.yaml ומציע להפעיל מחדש את ה-daemon.

ניתן גם להוסיף ידנית:

channels:
  telegram:
    # botToken מאוחסן ב-OS keychain
    ownerId: 8019881968
    classification: INTERNAL

אפשרות	סוג	נדרש	תיאור
botToken	string	כן	טוקן Bot API מ-@BotFather
ownerId	number	כן	מזהה המשתמש המספרי שלכם ב-Telegram
classification	string	לא	תקרת סיווג (ברירת מחדל: INTERNAL)

שלב 4: התחילו לשוחח

לאחר הפעלה מחדש של ה-daemon, פתחו את הבוט ב-Telegram ושלחו /start. הבוט יברך אתכם לאישור שהחיבור פעיל. אז תוכלו לשוחח עם הסוכן ישירות.

התנהגות סיווג

הגדרת ה-classification היא תקרה -- היא שולטת ברגישות המרבית של נתונים שיכולים לזרום דרך ערוץ זה עבור שיחות בעלים. היא אינה חלה באופן אחיד על כל המשתמשים.

כיצד זה עובד לכל הודעה:

• אתם שולחים הודעה לבוט (מזהה המשתמש תואם ל-ownerId): הסשן משתמש בתקרת הערוץ. עם ברירת המחדל INTERNAL, הסוכן יכול לשתף נתונים ברמה פנימית אתכם.
• מישהו אחר שולח הודעה לבוט: הסשן שלו מזוהם אוטומטית כ-PUBLIC ללא קשר לסיווג הערוץ. כלל אין-כתיבה-למטה מונע מנתונים פנימיים להגיע לסשן שלו.

משמעות הדבר שבוט Telegram יחיד מטפל בבטחה הן בשיחות בעלים והן בשיחות לא-בעלים. בדיקת הזהות מתרחשת בקוד לפני שה-LLM רואה את ההודעה -- ה-LLM אינו יכול להשפיע עליה.

סיווג ערוץ	הודעות בעלים	הודעות לא-בעלים
PUBLIC	PUBLIC	PUBLIC
INTERNAL (ברירת מחדל)	עד INTERNAL	PUBLIC
CONFIDENTIAL	עד CONFIDENTIAL	PUBLIC
RESTRICTED	עד RESTRICTED	PUBLIC

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

זהות בעלים

Triggerfish קובע סטטוס בעלים על ידי השוואת מזהה המשתמש המספרי ב-Telegram של השולח מול ה-ownerId המוגדר. בדיקה זו מתרחשת בקוד לפני שה-LLM רואה את ההודעה:

• התאמה -- ההודעה מתויגת כבעלים ויכולה לגשת לנתונים עד תקרת הסיווג של הערוץ
• ללא התאמה -- ההודעה מתויגת עם זיהום PUBLIC, וכלל אין-כתיבה-למטה מונע מנתונים מסווגים לזרום לסשן זה

הגדירו תמיד את מזהה הבעלים ללא ownerId, Triggerfish מתייחס

לכל השולחים כבעלים. כל מי שימצא את הבוט שלכם יוכל לגשת לנתונים עד רמת הסיווג של הערוץ. שדה זה נדרש במהלך ההגדרה מסיבה זו. :::

חלוקת הודעות

ל-Telegram מגבלת הודעה של 4,096 תווים. כאשר הסוכן מייצר תגובה ארוכה מזה, Triggerfish מחלק אותה אוטומטית למספר הודעות. המחלק מפצל על שורות חדשות או רווחים לצורך קריאות -- הוא נמנע מחיתוך מילים או משפטים באמצע.

סוגי הודעות נתמכים

מתאם ה-Telegram מטפל כרגע ב:

• הודעות טקסט -- תמיכה מלאה בשליחה וקבלה
• תגובות ארוכות -- מחולקות אוטומטית כדי להתאים למגבלות Telegram

מחווני הקלדה

כאשר הסוכן מעבד בקשה, הבוט מציג "מקליד..." בצ'אט ה-Telegram. המחוון פועל בזמן שה-LLM מייצר תגובה ומתנקה כאשר התשובה נשלחת.

שינוי סיווג

להעלאה או הורדה של תקרת הסיווג:

triggerfish config add-channel telegram
# בחרו לדרוס תצורה קיימת כשתתבקשו

או ערכו את triggerfish.yaml ישירות:

channels:
  telegram:
    # botToken מאוחסן ב-OS keychain
    ownerId: 8019881968
    classification: CONFIDENTIAL

רמות תקפות: PUBLIC, INTERNAL, CONFIDENTIAL, RESTRICTED.

הפעילו מחדש את ה-daemon לאחר שינוי: triggerfish stop && triggerfish start