הערה
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות להיכנס או לשנות מדריכי כתובות.
הגישה לדף זה מחייבת הרשאה. באפשרותך לנסות לשנות מדריכי כתובות.
נקודת הקצה להעברת הודעות לסוכן היא נקודת הקצה שאליה שולחים הודעות התראה אוטונומיות לסוכן שלך.
מחיקת נקודת קצה של העברת הודעות לסוכן
השתמש בפקודה a365 cleanup blueprint --endpoint-only כדי להסיר את רישום נקודת הקצה של העברת הודעות לסוכן. פקודה זו אינה משפיעה על קוד הסוכן או על נקודת הקצה שנפרסה. היא מסירה רק את רשומת ההרשמה דרך Teams Graph (פלטפורמת MCP).
a365 cleanup blueprint --endpoint-only
הגדרת נקודת קצה להודעות ב- a365.config.json
לפני הגדרת נקודת הקצה של ההודעות, ציין אותה בקובץ ההגדרות a365.config.json. קובץ זה מכיל את התצורה המרכזית של פריסת הסוכן.
הוסף או עדכן את מאפייני התצורה של נקודת קצה להעברת הודעות:
{
"messagingEndpoint": "https://your-endpoint-url.com/api/messages",
"deploymentProjectPath": "."
}
messagingEndpoint: ציין את כתובת האתר המדויקת של נקודת הקצה שבה תוכל לשלוח הודעות לסוכן.deploymentProjectPath: נתיב לספריית הפרויקט של הסוכן. המאפיין הזה לא רלוונטי אם הסוכן כבר פרוס ואינך צריך לעדכן את תצורת הסביבה. הגדר אתdeploymentProjectPathלערך.רק אם קוד הסוכן לא נמצא במחשב.
מאפייני תצורה
| מאפיין | תיאור | חובה | ברירת מחדל | דוגמה |
|---|---|---|---|---|
messagingEndpoint |
כתובת ה- URL שבה הסוכן מקבל הודעות | כן | ללא | https://your-app.azurewebsites.net/api/messages |
deploymentProjectPath |
נתיב לתיקיית פרויקט הסוכן לצורך עדכוני תצורה | לא | . |
./my-agent או . |
אפשרויות תצורה של נקודת קצה
הערך של messagingEndpoint תלוי בתרחיש הפריסה שלך:
עבור פריסות Azure:
- Azure Web App:
https://your-app-name.azurewebsites.net/api/messages
עבור פריסות שאינן של Azure:
- AWS:
https://your-api-gateway-url.amazonaws.com/api/messages - GCP:
https://your-cloud-run-url.run.app/api/messages - ספקי ענן אחרים: כתובת URL של נקודת הקצה המותאמת אישית
לבדיקות מקומיות עם מנהרות פיתוח:
- כתובת URL של מנהרת הפיתוח:
https://abc123xyz.devtunnels.ms:3978/api/messages
חשוב
ה- CLI deploymentProjectPath מציין היכן מחפש קבצי פרויקט והיכן הוא מעדכן את תצורת הסביבה, כגון קובצי .env.
הערה
כשאתה משתמש במנהרות פיתוח לבדיקות מקומיות, עדכן את ה- messagingEndpoint ב- a365.config.json עם כתובת ה- URL של מנהרת הפיתוח לפני הפעלת פקודת ההגדרה. למידע נוסף: בדיקות עם מנהרות פיתוח.
הגדרת נקודת קצה להעברת הודעות לסוכן
לאחר עדכון הקובץ a365.config.json, השתמש בפקודה זו כדי לרשום את נקודת קצה של העברת ההודעות, כך ששירות Agent 365 יוכל לשלוח התראות לסוכן שלך. הפעולה --endpoint-only רושמת את נקודת הקצה באמצעות Teams Graph (פלטפורמת MCP).
a365 setup blueprint --endpoint-only
ניתן גם להעביר את כתובת ה- URL ישירות עם --messaging-endpoint, במקום לערוך a365.config.json:
a365 setup blueprint --endpoint-only `
--messaging-endpoint https://your-app.azurewebsites.net/api/messages
במהלך בדיקות מקומיות, ניתן להגדיר את נקודת הקצה כנקודת קצה מסוג 'מנהרת פיתוח' לפני פריסת הסוכן לענן. למידע נוסף: בדיקות עם מנהרות פיתוח.
לעדכון כתובת URL של נקודת קצה קיימת:
a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages
פריסת נקודת הקצה
אם עדיין לא פרסת את הסוכן בענן, למד איך לפרוס סוכן ב-Azure.
אם כבר פרסת את הסוכן בענן, תוכל להגדיר את נקודת הקצה של ההודעות כפי שהוצג קודם.
כיצד להגדיר את נקודת הקצה של העברת ההודעות בשירותי ענן פופולריים נוספים: