McpToolServerConfigurationService class
שירות האחראי על גילוי ונורמלית של שרתי כלי MCP (פרוטוקול הקשר מודל) והפקת אובייקטי תצורה הניתנים לצריכה על-ידי ה- SDK של ה- SDK של ה- Cortandk.
בנאים
| Mcp |
בנה McpToolServerConfigurationService. |
שיטות
| get |
התחבר לשרת MCP והחזר כלים עם שמות קידומת על-ידי שם השרת. אפשרות זו מתרחשת אם כתובת ה- URL של השרת חסרה או אם הלקוח נכשל ברישום כלים. |
| list |
החזר הגדרות שרת MCP עבור הסוכן הנתון. בפיתוח (NODE_ENV=פיתוח) זה קורא את ToolingManifest.json; אחרת, הוא יהשאילתה את שער הכלים המרוחק. |
| list |
החזר הגדרות שרת MCP עבור הסוכן הנתון. בפיתוח (NODE_ENV=פיתוח) זה קורא את ToolingManifest.json; אחרת, הוא יהשאילתה את שער הכלים המרוחק. |
| list |
החזר הגדרות שרת MCP עבור הסוכן הנתון. בפיתוח (NODE_ENV=פיתוח) זה קורא את ToolingManifest.json; אחרת, הוא יהשאילתה את שער הכלים המרוחק. עומס יתר זה פותר באופן אוטומטי את agenticAppId מ- TurnContext ומפיק את אסימון האימות אם לא מסופק. |
| send |
שליחת היסטוריית צ'אט לפלטפורמת MCP להגנה מפני איומים בזמן אמת. |
| send |
שליחת היסטוריית צ'אט לפלטפורמת MCP להגנה מפני איומים בזמן אמת. |
פרטי הבנאי
McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)
בנה McpToolServerConfigurationService.
new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)פרמטרים
- configProvider
ספק תצורה אופציונלי. ברירות מחדל ל- defaultToolingConfigurationProvider אם לא צוין.
פרטי פעולת השירות
getMcpClientTools(string, MCPServerConfig)
התחבר לשרת MCP והחזר כלים עם שמות קידומת על-ידי שם השרת. אפשרות זו מתרחשת אם כתובת ה- URL של השרת חסרה או אם הלקוח נכשל ברישום כלים.
function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>פרמטרים
- mcpServerName
-
string
- mcpServerConfig
- MCPServerConfig
החזרות
Promise<McpClientTool[]>
listToolServers(string, string)
אזהרה
API זה אינו בשימוש עוד.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
החזר הגדרות שרת MCP עבור הסוכן הנתון. בפיתוח (NODE_ENV=פיתוח) זה קורא את ToolingManifest.json; אחרת, הוא יהשאילתה את שער הכלים המרוחק.
function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>פרמטרים
- agenticAppId
-
string
מזהה היישום הסוכןי שעבורו יש לגלות שרתים.
- authToken
-
string
אסימון של נושא נמצא בשימוש בעת ביצוע שאילתה על שער הכלים המרוחק.
החזרות
Promise<MCPServerConfig[]>
הבטחה לפתרון למערך של אובייקטי תצורה של שרת MCP מנושר.
listToolServers(string, string, ToolOptions)
אזהרה
API זה אינו בשימוש עוד.
Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.
החזר הגדרות שרת MCP עבור הסוכן הנתון. בפיתוח (NODE_ENV=פיתוח) זה קורא את ToolingManifest.json; אחרת, הוא יהשאילתה את שער הכלים המרוחק.
function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>פרמטרים
- agenticAppId
-
string
מזהה היישום הסוכןי שעבורו יש לגלות שרתים.
- authToken
-
string
אסימון של נושא נמצא בשימוש בעת ביצוע שאילתה על שער הכלים המרוחק.
- options
- ToolOptions
אפשרויות כלי אופציונליות בעת קריאה לשער.
החזרות
Promise<MCPServerConfig[]>
הבטחה לפתרון למערך של אובייקטי תצורה של שרת MCP מנושר.
listToolServers(TurnContext, Authorization, string, string, ToolOptions)
החזר הגדרות שרת MCP עבור הסוכן הנתון. בפיתוח (NODE_ENV=פיתוח) זה קורא את ToolingManifest.json; אחרת, הוא יהשאילתה את שער הכלים המרוחק. עומס יתר זה פותר באופן אוטומטי את agenticAppId מ- TurnContext ומפיק את אסימון האימות אם לא מסופק.
function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>פרמטרים
- turnContext
- TurnContext
ה- TurnContext של הבקשה הנוכחית.
- authorization
- Authorization
אובייקט הרשאה עבור חילופי אסימון.
- authHandlerName
-
string
שם המטפל באימות לשימוש עבור חילופי אסימונים.
- authToken
-
string
אסימון נושא אופציונלי. אם לא צוין, ילהפיק באופן אוטומטי באמצעות חילופי אסימון.
- options
- ToolOptions
אפשרויות כלי אופציונליות בעת קריאה לשער.
החזרות
Promise<MCPServerConfig[]>
הבטחה לפתרון למערך של אובייקטי תצורה של שרת MCP מנושר.
sendChatHistory(TurnContext, ChatHistoryMessage[])
שליחת היסטוריית צ'אט לפלטפורמת MCP להגנה מפני איומים בזמן אמת.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>פרמטרים
- turnContext
- TurnContext
הקשר ההקשר של ההפעלה מכיל מידע אודות השיחה.
- chatHistoryMessages
הודעות היסטוריית הצ'אט לשליחה.
החזרות
Promise<OperationResult>
A Promise that resolves to an OperationResult indicating success or failure.
הערות
חריגות HTTP (שגיאות רשת, תם הזמן הקצוב) נתפסים נרשם אך לא מתרחשים מחדש. במקום זאת, פעולת השירות מחזירה OperationResult המציין אם הפעולה הצליחה או נכשלה. המתקשרים יכולים לבחור לבדוק את התוצאה לטיפול בשגיאות או להתעלם ממנה אם אין צורך בפרטי שגיאה.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
שליחת היסטוריית צ'אט לפלטפורמת MCP להגנה מפני איומים בזמן אמת.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>פרמטרים
- turnContext
- TurnContext
הקשר ההקשר של ההפעלה מכיל מידע אודות השיחה.
- chatHistoryMessages
הודעות היסטוריית הצ'אט לשליחה.
- options
- ToolOptions
אפשרויות כלי אופציונליות לשליחת היסטוריית צ'אט.
החזרות
Promise<OperationResult>
A Promise that resolves to an OperationResult indicating success or failure.
הערות
חריגות HTTP (שגיאות רשת, תם הזמן הקצוב) נתפסים נרשם אך לא מתרחשים מחדש. במקום זאת, פעולת השירות מחזירה OperationResult המציין אם הפעולה הצליחה או נכשלה. המתקשרים יכולים לבחור לבדוק את התוצאה לטיפול בשגיאות או להתעלם ממנה אם אין צורך בפרטי שגיאה.