Utility class
מאפיינים
| HEADER_AGENT_ID | שם כותרת עבור שליחת מזהה הסוכן אל פלטפורמת MCP לרישום/ניתוח. |
| HEADER_CHANNEL_ID | |
| HEADER_SUBCHANNEL_ID | |
| HEADER_USER_AGENT |
שיטות
| Build |
בנה את כתובת ה- URL המלאה לצורך גישה לשרת MCP ספציפי. דוגמה: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/" |
| Get |
בונה את כתובת ה- URL של נקודת הקצה לשליחת היסטוריית צ'אט אל פלטפורמת MCP להגנה מפני איומים בזמן אמת. |
| Get |
קבל את כתובת ה- URL הבסיסית המשמשת לשאילתה בסביבות MCP. |
| Get |
בנה את כתובת ה- URL של שער כלי עבור זהות סוכן נתונה. נקודת קצה זו משמשת לגילוי שרתי MCP המשויכים לזהות הסוכן שצוינה. דוגמה: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers" |
| Get |
חבר כותרות רגילות עבור בקשות לכלי MCP. כולל אסימון של נושא ההרשאה כאשר הוא מסופק, והוא כולל גם מזהי ערוץ ומשפך משנה לניתוב. |
| Validate |
אימות אסימון אימות JWT. בדיקה שהאסימונים הם JWT חוקיים ושפג תוקפו של האסימון לא פג. |
פרטי המאפיין
HEADER_AGENT_ID
שם כותרת עבור שליחת מזהה הסוכן אל פלטפורמת MCP לרישום/ניתוח.
static HEADER_AGENT_ID: "x-ms-agentid" = "x-ms-agentid"ערך הנכס
"x-ms-agentid"
HEADER_CHANNEL_ID
static HEADER_CHANNEL_ID: "x-ms-channel-id" = "x-ms-channel-id"ערך הנכס
"x-ms-channel-id"
HEADER_SUBCHANNEL_ID
static HEADER_SUBCHANNEL_ID: "x-ms-subchannel-id" = "x-ms-subchannel-id"ערך הנכס
"x-ms-subchannel-id"
HEADER_USER_AGENT
static HEADER_USER_AGENT: "User-Agent" = "User-Agent"ערך הנכס
"User-Agent"
פרטי פעולת השירות
BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)
אזהרה
API זה אינו בשימוש עוד.
This method is for internal use only. Use McpToolServerConfigurationService instead.
בנה את כתובת ה- URL המלאה לצורך גישה לשרת MCP ספציפי.
דוגמה: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
static function BuildMcpServerUrl(serverName: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringפרמטרים
- serverName
-
string
שם המשאב של שרת MCP.
- configProvider
ספק תצורה אופציונלי. ברירות מחדל ל- defaultToolingConfigurationProvider.
החזרות
string
כתובת ה- URL של שרת MCP המלא, כולל קו נטוי נגרר.
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)
אזהרה
API זה אינו בשימוש עוד.
This method is for internal use only. Use McpToolServerConfigurationService.sendChatHistory() instead.
בונה את כתובת ה- URL של נקודת הקצה לשליחת היסטוריית צ'אט אל פלטפורמת MCP להגנה מפני איומים בזמן אמת.
static function GetChatHistoryEndpoint(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringפרמטרים
- configProvider
ספק תצורה אופציונלי. ברירות מחדל ל- defaultToolingConfigurationProvider.
החזרות
string
כתובת URL מוחלטת שרכיבי כלי יכולים להשתמש בה כדי לשלוח או לאחזר הודעות צ'אט עבור תרחישים של הגנה מפני איומים בזמן אמת.
הערות
התקשר לשיטה זו בעת בניית בקשות HTTP שיש לגשת להיסטוריית הודעות הצ'אט לקבלת הגנה מפני איומים בזמן אמת. כתובת ה- URL המוחזרת כבר כוללת את כתובת הבסיס של פלטפורמת MCP ואת מקטע הנתיב הקבוע /agents/real-time-threat-protection/chat-message.
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)
אזהרה
API זה אינו בשימוש עוד.
This method is for internal use only. Use McpToolServerConfigurationService instead.
קבל את כתובת ה- URL הבסיסית המשמשת לשאילתה בסביבות MCP.
static function GetMcpBaseUrl(configProvider?: IConfigurationProvider<ToolingConfiguration>): stringפרמטרים
- configProvider
ספק תצורה אופציונלי. ברירות מחדל ל- defaultToolingConfigurationProvider.
החזרות
string
כתובת ה- URL של סביבת MCP הבסיסית.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)
אזהרה
API זה אינו בשימוש עוד.
This method is for internal use only. Use McpToolServerConfigurationService.listToolServers() instead.
בנה את כתובת ה- URL של שער כלי עבור זהות סוכן נתונה. נקודת קצה זו משמשת לגילוי שרתי MCP המשויכים לזהות הסוכן שצוינה.
דוגמה: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
static function GetToolingGatewayForDigitalWorker(agenticAppId: string, configProvider?: IConfigurationProvider<ToolingConfiguration>): stringפרמטרים
- agenticAppId
-
string
המזהה הייחודי עבור זהות הסוכן.
- configProvider
ספק תצורה אופציונלי. ברירות מחדל ל- defaultToolingConfigurationProvider.
החזרות
string
כתובת URL מלאה המצביעה על שער כלי עבור הסוכן.
GetToolRequestHeaders(string, TurnContext, ToolOptions)
חבר כותרות רגילות עבור בקשות לכלי MCP. כולל אסימון של נושא ההרשאה כאשר הוא מסופק, והוא כולל גם מזהי ערוץ ומשפך משנה לניתוב.
static function GetToolRequestHeaders(authToken?: string, turnContext?: TurnContext, options?: ToolOptions): Record<string, string>פרמטרים
- authToken
-
string
אסימון של נושא עבור כותרת הרשאה.
- turnContext
- TurnContext
אובייקט TurnContext אופציונלי ממנו מחולצים זהי ערוץ ומשפך משנה.
- options
- ToolOptions
אובייקט ToolOptions אופציונלי עבור תצורת בקשה נוספת.
החזרות
Record<string, string>
רשומת כותרות המתאימה לבקשות HTTP.
ValidateAuthToken(undefined | string)
אימות אסימון אימות JWT. בדיקה שהאסימונים הם JWT חוקיים ושפג תוקפו של האסימון לא פג.
static function ValidateAuthToken(authToken: undefined | string)פרמטרים
- authToken
-
undefined | string
אסימון JWT לאימות.