מגייסי תרומות מבקשים מ־Copilot ב־Outlook או ב־Teams לנסח תשובה לתורם, ומקבלים מייל אישי שנבנה מהתרומות וההערות האמיתיות של אותו תורם ב־CRM. לקחתי את הסוכן מפיילוט ללקוח אחד לתכנון מרובה טננטים: חבילת Marketplace אחת ו־backend אחד, וכל ארגון מחבר את מפתח ה־CRM שלו.
מספרים שמסומנים ”הערכה” הם הערכות הנדסיות שצריך לאמת מול הספקית. כל השאר נספרו מהקוד, מהטסטים וממסמכי הפרויקט.
הגרסה הראשונה שירתה ארגון פיילוט אחד, ומפתח ה־API של ה־CRM היה הגדרה אחת ב־backend שנקראת בעלייה. כשספקית ה־CRM בדקה את ההתקנה, היא מצאה את התוצאה המתבקשת: חבילה אחת היא backend אחד, ו־backend אחד הוא מפתח אחד שמשותף לכל מי שמתקין.
לכן רישום Marketplace בשירות עצמי היה מחייב build ו־backend מאורח נפרדים לכל לקוח. זה לא היה מקובל, וגם לא מפתח אחד משותף לכל הארגונים.
single / multi שמר על הפיילוט בלי שינוי בזמן שהמסלול החדש עלה.התרשים רחב מהמסך: החליקו הצידה לצפייה בכולו →
שני ארגונים הם שני מזהי טננט, שתי שורות ושני מפתחות. בקשה יכולה להשתמש רק במפתח שמתאים לזהות המאומתת שלה. נתיבי הניהול והזנת המפתח פתוחים רק למנהלי הארגון, ומפתחות לא מופיעים בלוגים, שבהם גם כתובות המייל של התורמים מוסתרות.
מפתח ה־CRM עבר מסוד של הפריסה לקונפיגורציה בזמן ריצה, לפי מזהה טננט ה־Entra. חבילת Teams היא קובץ סטטי שכולם מורידים, ולכן היא לא יכולה לשאת סוד של לקוח. המחיר: ממשק ה־Outlook היה צריך לעבור מבלי הזדהות ל־Entra SSO, כדי שהקריאות שלו יזהו את הארגון.
טיוטות מתחילות מתבניות דטרמיניסטיות שמכניסות placeholders מפורשים כשחסר מידע. השכתוב ב־gpt-4o משנה רק טון ואורך, חייב לשמר את ה־placeholders כמו שהם, וחוזר לתבנית אם הוא נכשל.
Microsoft תומכת בסוכני custom engine רק ב־Teams וב־Copilot Chat, וב־declarative agents ב־Outlook וב־Office. הרצה של שניהם על backend אחד מגיעה למשתמשים בכל מקום בלי עלות תשתית נוספת. המחיר: שתי חבילות Teams לתחזק.
כל ארגון עם מפתח תקין יכול להתחבר, כי המפתח עצמו הוא השער. דגל אישור נשאר ברשומה, כך שהספקית תוכל להפעיל allow-list בהמשך בלי לתכנן מחדש.
בעיות שעלו בבדיקות עם הספקית, ואיך הן נסגרו:
בדיקת ההתקנה של הספקית עצמה הראתה שהגדרת המפתח היחידה ב־backend גורמת לכל המתקינים לחלוק מפתח אחד, או מחייבת build מותאם לכל לקוח.
מאגר מפתחות ו־resolver לכל טננט מאחורי חבילה אחת. מצב תאימות לאחור השאיר את הפיילוט החי בלי שינוי בזמן שהשינוי עלה.
ה־plugin של ה־declarative agent עבד בלי הזדהות, ולכן ה־backend לא ידע איזה ארגון קורא ולא יכול היה לבחור מפתח.
העברתי את ה־plugin ל־Entra SSO והוספתי middleware לאימות JWT בנתיבי ה־actions, במקום מפתח ה־actions המשותף.
בהגדרה בשירות עצמי, טעות הקלדה במפתח הייתה מתגלה רק מאוחר יותר, כטיוטה שנכשלה למגייס תרומות.
המפתח מאומת בזמן השמירה בבדיקת קריאה אחת, בלי ניסיונות חוזרים. מפתחות לא תקינים נדחים ושום דבר לא נשמר.
הסוכנים נשמרים ב־cache לכל טננט לטובת מהירות, ולכן מפתח שהוחלף היה יכול להיות מתעלם ממנו עד restart.
רשומת ה־cache זוכרת איזה מפתח בנה את הסוכן. מפתח אחר בונה אותו מחדש, ו־API הניהול מאפס את הרשומה בכל שינוי.
כרטיס הצ׳אט היה מאפשר לכל חבר צוות להחליף את המפתח של הארגון.
הגבלה למנהלים בלבד דרך רשימת חברי ה־Team (בעלים או מנהל), יחד עם הצפנה במנוחה והסתרה של מפתחות ומיילים של תורמים בלוגים.
טיוטות מרובות נתקלו ב־429 ומדי פעם ב־5xx מה־CRM.
עד 3 ניסיונות חוזרים עם backoff אקספוננציאלי ו־full jitter, כיבוד Retry-After, ורענון טוקן אחד כש־session פג.
גרסה 0.x, כתובת סכמה לא קנונית, מזהה סוכן שאינו GUID, כתובת spec מרוחקת ודגל confirmation לא נתמך נדחו כל אחד בתורו.
תיקנתי כל אחד מהם והוספתי סקריפטי build לחבילת הפריסה ולחבילות לכל טננט. תשעה כללי אריזה מתועדים במסמכים.
הדגמה להמחשה עם טננטים ותורמים סינתטיים. אין בה נתוני לקוח או קוד. כל תרחיש מציג את הבדיקות שה־backend מריץ.
| מדד | לפני | אחרי | מקור |
|---|---|---|---|
| פריסות עבור N ארגונים | N (אחת לכל לקוח) | backend אחד + חבילה אחת | נגזר |
| קליטת ארגון | חבילה ו־backend ידניים, ≈יום | מנהל מדביק מפתח, ≈5 דק׳ | הערכה |
| מפתח לכל ארגון | מפתח משותף אחד | מפתח מוצפן לכל טננט | קוד |
| זהות בממשק ה־Outlook | אין | Entra SSO, JWT מאומת | קוד |
| זיהוי מפתח שגוי | בטיוטה הראשונה שנכשלת | בשמירה, שום דבר לא נשמר | קוד |
| בדיקות אוטומטיות בכל push | — | 96 טסטים + lint, טיפוסים, build, evals | קוד |
מקור: קוד = בריפו; נגזר = נובע מהתכנון; הערכה = לאימות מול הספקית.
שיחת אבחון חינם · 30 דקות · ללא התחייבות
כתבו בכמה שורות: איזה תהליך או מערכת, מה כואב היום (זמן, טעויות, עלויות או פיילוט AI שנתקע) ומי עובד עם זה. אחרי שיחה קצרה מקבלים תוך כ־3 ימים תוכנית כתובה והצעת מחיר סגורה.
נפתח מייל מוכן מראש · מענה תוך יום עסקים
ה־AI קורא. הקוד סופר.
כל הפרויקטים