הרשאות ואישורים
הסוכן שלך עובד ב-Ploa עם טוקן. רמת הטוקן קובעת במה מותר לו לגעת ומה מותר לו לבקש, וכל מה שאי אפשר לבטל מחכה לאישור שלך: App Review, פרודקשן, מחירים, בודקים שמקבלים מייל, תגובות לביקורות. אלא אם הפכת את הסוכן הזה לאוטונומי.
ארבע הרמות
לכל טוקן יש רמה אחת, ורמה גבוהה כוללת את כל מה שמתחתיה. בוחרים אותה כשמאשרים את ploa login, כשיוצרים טוקן, או אחר כך בהגדרות › טוקנים, ושם שינוי חל מיד והסוכן ממשיך לעבוד.
| רמה | מה מותר לו |
|---|---|
| קריאה | לראות את האפליקציות, הבניות, המצב בחנויות, דף החנות, ביקורות, מכירות ודוחות. לא משנה כלום. |
| טיוטה | לכתוב טיוטות (טקסט לחנות, תשובות פרטיות ותשובות על הצפנה), לקשר ולהוסיף אפליקציות, לבנות ולשלוח בניות לבודקים (TestFlight, הבדיקה הפנימית של Google Play, כתובת הבדיקה של גרסת אתר), לעצור בנייה, ולעבוד על האתר והשרת של האפליקציה. מותר לו לבקש: קישור ריפו ב-GitHub, הגדרות GitHub של האפליקציה, קובצי בנייה, וצעדים שרק אתה יכול לעשות. |
| הגשה לבדיקה | גם לשלוח שינויים ישר לחנויות (דף החנות, צילומי מסך וסרטונים, קבוצות TestFlight ו-What to Test), ולבקש App Review, בודקים, מוצרים, הצעות, RevenueCat, תגובות לביקורות, דפי מוצר, בדיקות A/B ו-In-App Events. |
| פרודקשן | גם לבקש שחרור לפרודקשן, הפצה הדרגתית ועצירה ב-Google Play, שחרור ב-App Store והשחרור ההדרגתי שלו, המחיר ואפשרות השחרור ב-App Store, והעלאה לאוויר של גרסת אתר. |
סוכן יכול לבקש רק את מה שהרמה שלו מתירה: בקשה ל-App Review מטוקן ברמת טיוטה נדחית, ולא מגיעה אליך. לסוכן שמביא את האפליקציה עד החנויות בוחרים הגשה לבדיקה, או פרודקשן בשביל שחרורים ומחירים.
הרמה היא המקסימום שמותר לטוקן; מה שהסוכן עושה מצומצם יותר. ההנחיות של Ploa משאירות את הסוכנים בטיוטות בדף החנות: הם שומרים, ואתה שולח לחנויות בלחיצה אחת, אלא אם הסוכן אוטונומי. וטוקן אף פעם לא רואה ערך של סוד, לא מחליט על בקשה (שלו או של מישהו אחר), ולא יוצר טוקן אחר.
הסוכנים של חבר צוות
טוקן אף פעם לא עושה יותר ממי שהוא שייך לו. הבעלים בוחרים מה כל חבר צוות רשאי לעשות (אפליקציות ובנייה, דף החנות, App Review ופרודקשן, ביקורות, חנויות, מפתחות ו-GitHub, מכירות והכנסות, סוכנים וטוקנים, תוכנית ותשלום, אבטחה, סוכנים אוטונומיים; פרטים במה חבר צוות רשאי לעשות), והסוכנים והטוקנים של חבר הצוות מקבלים בדיוק את זה. סירוב אומר איזו הרשאה הבעלים לא נתנו. כדי להחליט על אישור צריך את ההרשאה למה שהוא מבקש, ובקשה של סוכן אוטונומי שלחבר הצוות שלו אין את ההרשאה מחכה לאישור של מי שיש לו אותה.
מאיפה טוקנים מגיעים
-
ploa loginבמחשב: מאשרים את הקוד ב-ploa.dev ובוחרים שם את הרמה (הגשה לבדיקה נבחרת מראש). בעלים, וחברי צוות שקיבלו את ההרשאה, יכולים לבחור גם סוכן אוטונומי. - הגדרות › טוקנים בלוח הבקרה: ל-CI, לשרתים ול-
PLOA_TOKEN. הטוקן מוצג פעם אחת. - השרת ברשת (
ploa.dev/mcp): כשמאשרים סוכן, בוחרים קריאה בלבד, טיוטות ובניות, או טיוטות, בניות ובקשות, והטוקן נקרא על שם הסוכן, עם "(web)". בעצמו הוא אף פעם לא עובר את הטיוטות והבניות; עם בקשות הוא מבקש ממך את כל מה שבטבלה למטה, וכל בקשה מחכה לאישור שלך. הוא לא יכול להיות אוטונומי או לשנות את החנויות ישירות; בשביל זה משתמשים בסוכן שבמחשב שלך. משנים את הבחירה בהגדרות › טוקנים.
כל טוקן מופיע בהגדרות › טוקנים עם הרמה שלו והשימוש האחרון, ואפשר לבטל אותו שם. הבעלים של סביבת העבודה מקבלים הודעה בכל פעם שנוצר טוקן. בניות ש-Ploa מריצה ב-GitHub נכנסות בשם ההרצה עצמה, עם טוקן קצר מועד שלא יכול לשנות כלום חוץ מהבנייה שלו.
מה מחכה לאישור שלך
כשסוכן או ה-CLI מפעילים את אחד הדברים האלה, הוא נשלח כבקשה ולא מתבצע. את הרמה שכל אחד דורש קובעת Ploa, לא מי שקורא לו. בלוח הבקרה אתה עושה אותם מיד.
| מה | רמה כדי לבקש | מהסוכן |
|---|---|---|
| הגשה של גרסת iOS ל-App Review, או שליחת בנייה חדשה יותר במקום זו ש-App Review בודק | הגשה לבדיקה | ploa_release_submit_review |
| משיכת גרסה מ-App Review | הגשה לבדיקה | ploa_release_withdraw_review |
| קידום גרסת אנדרואיד לפרודקשן (או ל-beta, alpha), בהפצה הדרגתית או לכולם | פרודקשן | ploa_release_promote |
| שחרור ב-App Store של הגרסה ש-App Review אישר | פרודקשן | ploa_appstore_release |
| שינוי הפצה הדרגתית: המשך או סיום של שחרור הדרגתי ב-App Store, או האחוז בהפצה ב-Google Play | פרודקשן | ploa_appstore_phased_release; את Google Play בלוח הבקרה |
| עצירת גרסה: השהיית שחרור הדרגתי ב-App Store, או עצירת הפצה ב-Google Play | פרודקשן | ploa_appstore_phased_release; את Google Play בלוח הבקרה |
| שינוי המחיר ב-App Store | פרודקשן | ploa_details_save (price), ploa_details_send |
| הבחירה אם גרסה ב-App Store משתחררת ברגע ש-App Review מאשר אותה, או רק כשאתה משחרר אותה | פרודקשן | ploa_appstore_release_type |
| העלאה לאוויר של גרסת אתר, בכתובת שלו ובדומיינים | פרודקשן | ploa_web_release |
| הזמנת בודקים ל-TestFlight (Apple שולחת מייל לכל אחד) | הגשה לבדיקה | ploa_testflight_save |
| שליחת בנייה ל-beta review של TestFlight | הגשה לבדיקה | ploa_testflight_save |
| שינוי מי שבודק ב-Google Play | הגשה לבדיקה | ploa_play_testers_save |
| העברת הבודקים לבנייה החדשה ביותר והוצאת בניות TestFlight ישנות | הגשה לבדיקה | לוח הבקרה |
| יצירת מוצר או מנוי בתוך האפליקציה, או שינוי המחיר שלו | הגשה לבדיקה | ploa_product_save |
| יצירה או תמחור של הצעה למנוי, או יצירת קודי הצעה | הגשה לבדיקה | ploa_offer_save, ploa_offer_codes |
| יצירת מוצר ב-RevenueCat | הגשה לבדיקה | ploa_revenuecat_create_product |
| שליחת מוצר בתוך האפליקציה לבדיקה, או העלאה שלו למכירה | הגשה לבדיקה | ploa_product_submit |
| תגובה מתחת לביקורת של לקוח | הגשה לבדיקה | ploa_review_reply |
| שליחת דף מוצר מותאם או בדיקת A/B ל-App Review, או התחלה ועצירה של בדיקה | הגשה לבדיקה | ploa_marketing_save |
| שליחת In-App Event ל-App Review | הגשה לבדיקה | ploa_event_submit |
| שליחה עכשיו ל-App Store של שינויים שנשמרו בזמן App Review, במקום כש-Apple מחליטה | הגשה לבדיקה | ploa_held_changes |
הוספת קובצי בנייה מעותק מקומי (google-services.json, .env…), לבניות ב-GitHub | טיוטה | ploa_build_files_push |
| קישור האפליקציה לריפו שלה ב-GitHub | טיוטה | ploa_github_setup |
| שינוי הגדרות GitHub של האפליקציה (תוויות ל-PR, iOS על ה-Mac של GitHub, Releases ב-GitHub, דף החנות מהריפו, issues מהחנויות). iOS על ה-Mac של GitHub מנצל דקות של GitHub, ולכן את זה מאשרים בעלים, או חבר צוות עם ההרשאה "תוכנית ותשלום" | טיוטה | ploa_github_settings |
| משהו שרק אתה יכול לעשות: טופס בקונסולה של חנות, הצהרה, הסכם | טיוטה | ploa_ask_person, או ש-Ploa פותחת אותו בעצמה |
לעצירת בנייה, לשליחת דף החנות וטופס Data safety, ולהצהרת ההצפנה יש דרך משלהם: ראה עצירת בנייה ומה רק אתה שולח.
איך אישור עובד
- הסוכן מבקש
הכלי חוזר מיד עם מזהה בקשה וקישור. הסוכן אומר לך בשורה מה ביקש.
- מקבלים הודעה
הבקשה מופיעה בדף אישורים בלוח הבקרה ובדפי האפליקציה, וגם כהתראה בטלפון ובמחשב אם הפעלת התראות.
- מחליטים
מאשרים, או דוחים עם סיבה שהסוכן רואה. כדי להחליט צריך את ההרשאה למה שהבקשה עושה.
- Ploa מבצעת
Ploa שולחת לחנות, והסוכן קורא את התוצאה עם
ploa_approval_status. אם החנות מסרבת, הבקשה מראה למה.
בקשה שאף אחד לא מחליט עליה פגה אחרי 7 ימים; קובצי בנייה אחרי 24 שעות, ואז קבצים שלא אושרו נמחקים. הסוכן אף פעם לא מחפש דרך לעקוף בקשה: הוא מחכה, או שואל אותך.
צעדים שרק אתה יכול לעשות
לחלק מהצעדים בחנויות אין API: App Privacy של Apple, טופסי App content ב-Play Console חוץ מ-Data safety, הסכמים שרק ה-Account Holder מקבל, הצהרות שהן ההצהרה שלך. הם מגיעים לדף האישורים שלך כמשימות, ש-Ploa פותחת כשחנות עוצרת בקשה, או שהסוכן פותח עם ploa_ask_person. בכל משימה יש צעדים ממוספרים עם התשובות המדויקות והקישור לקונסולה; עושים אותה בקונסולה ולוחצים עשיתי. הסוכן מעביר אותך באותם צעדים גם בצ'אט. משימה אף פעם לא מאושרת מראש, גם לא לסוכן אוטונומי.
מה רק אתה שולח
- דף החנות: הסוכן שומר טיוטות; אתה בודק ושולח את כולן בלחיצה אחת בדף פרטי החנות. סוכן אוטונומי יכול לשלוח אותן בעצמו (
ploa_details_send). - Data safety מחליף את מה שיש ב-Play Console, והצהרת ההצפנה היא ההצהרה שלך מול Apple, ולכן אתה שולח אותם בעצמך (או סוכן אוטונומי).
- סימון ש-App Privacy או הצהרה ב-Play מולאו בקונסולה הוא סימון שאתה עושה בעצמך ב-Ploa, וכך גם הוספת מפתח ההעלאה של אנדרואיד, אלא אם הסוכן אוטונומי.
עצירת בנייה
עצירת בנייה היא לא אישור, אבל היא גם לא קורית בקריאה אחת. ploa_release_stop קודם מסביר מה העצירה עושה במקום שבו הבנייה רצה; הסוכן מראה לך, ועוצר את הבנייה רק אחרי שאתה מסכים. לוח הבקרה וציר הזמן של הבנייה מציינים אחר כך את הסוכן שעצר אותה.
סוכנים אוטונומיים
סוכן אוטונומי עובד בלי לחכות לך. מה שהיה מחכה לאישור (App Review, פרודקשן, מחירים, בודקים, מוצרים, RevenueCat) מאושר מראש ומתבצע מיד, והצעדים שאחרת רק אתה יכול לעשות (הוספת מפתחות חנות ומפתחות חתימה, חיבור RevenueCat, הגדרות האפליקציה, סימון ש-App Privacy או הצהרה ב-Play מולאו, שליחת דף החנות) פתוחים בפניו. לטוקן שלו יש רמת פרודקשן.
גם אז אלה נשארים בידיים שלך ושל הצוות: מחיקה של כל דבר (אפליקציות, מפתחות חנות, מפתחות חתימה, RevenueCat), החלטה על בקשות של סוכנים אחרים, חברי צוות, הזמנות, טוקנים, מפתחות גישה וחיבורים פעילים, הכספת ויומן הפעולות, והצעדים שרק אתה יכול לעשות בקונסולה של חנות.
- מי יכול להפעיל: מי שהטוקן שייך לו, כשהוא מחובר, אם הוא בעלים או חבר צוות שקיבל את ההרשאה "סוכנים אוטונומיים". כשמאשרים את
ploa login, כשיוצרים טוקן, או אחר כך בהגדרות › טוקנים, ושם מקלידים מילה כדי לאשר. - אף פעם לא הסוכן: סוכן יכול לבקש את זה (בהמשך), אבל לא לתת את זה לעצמו. סוכן ברשת לא יכול להיות אוטונומי בכלל.
- סוכן של חבר צוות עדיין לא עושה יותר ממה שמותר לחבר הצוות שלו: בקשה שההרשאות שלו לא מכסות מחכה לאישור של מי שיש לו אותן.
- סיום: בחירת רמה אחרת לטוקן, או ביטול שלו.
הכול עדיין נרשם. באישורים כתוב "אושר מראש על ידי סוכן אוטונומי", ויומן הפעולות מציין את הטוקן. סוכנים אוטונומיים קיימים בכל תוכנית, כולל Free.
בחירה בהתחלה
כשהסוכן שלך מתחיל לעבוד עם Ploa (ploa_setup_guide), וכל עוד לא בחרת, השאלה הראשונה שלו היא איך לעבוד:
- סוכן אוטונומי: הוא פועל מיד, כולל App Review, פרודקשן, מחירים, בודקים ומוצרים, והכול נרשם בשמו.
- אישורים: כל בדיקה, שחרור ושינוי מחיר מחכים לאישור שלך ב-Ploa, מההתראה או מדף האישורים; את כל השאר הוא מכין.
הוא רושם את התשובה שלך עם ploa_access. בחירה באישורים חלה מיד, והסוכן לא שואל שוב. אם הטוקן שלו ברמת קריאה או טיוטה, הוא אומר לך שהוא עוד לא יכול אפילו לבקש בדיקות ושחרורים, ומקשר להגדרות › טוקנים, ושם מעלים אותו להגשה לבדיקה או לפרודקשן.
אוטונומי הוא רק בקשה: הסוכן נותן לך קישור שפותח את הגדרות › טוקנים על הטוקן של אותו סוכן, ושם, כשאתה מחובר, קוראים מה זה אומר, מקלידים את המילה ומאשרים, או משאירים אותו על אישורים. עד שתאשר, הוא עובד עם אישורים. אם אין לך אפשרות לאשר (חבר צוות בלי ההרשאה), הוא אומר את זה: בעלים נותן לך קודם את ההרשאה בדף חברי הצוות, או משאיר את הסוכן על אישורים.
הכרטיס איך מתחילים בלוח הבקרה מציע את אותה בחירה, וטוקן שהסוכן שלו ביקש מראה את זה בשורה שלו בהגדרות › טוקנים. משנים את זה שם בכל רגע.
לעקוב אחרי מה שהסוכנים עושים
- לוח סוכנים: על מה כל סוכן עובד, מה מחכה לך, מה תקוע ומה הסתיים השבוע.
- הרצות שחרור: כל שחרור צעד אחר צעד, עם מי שהתחיל אותו, בדפי האפליקציה ודרך
ploa_runs. - יומן פעולות: כל שינוי, מי עשה אותו ומאיפה, ביומן משורשר ב-hash שאף אחד לא יכול לערוך בשקט.