McpToolServerConfigurationService class
Υπηρεσία που είναι υπεύθυνη για τον εντοπισμό και την κανονικοποίηση των διακομιστών εργαλείων MCP (Model Context Protocol) και την παραγωγή αντικειμένων ρύθμισης παραμέτρων που έχουν δυνατότητα χρήσης από το Claude SDK.
Κατασκευές
| 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
Το αναγνωριστικό agentic app για το οποίο θα ανακαλύπτουν διακομιστές.
- 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
Το αναγνωριστικό agentic app για το οποίο θα ανακαλύπτουν διακομιστές.
- 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
Το όνομα του χειρισμού ελέγχου ταυτότητας που θα χρησιμοποιηθεί για exchange διακριτικού.
- authToken
-
string
Προαιρετικό διακριτικό φορέα. Εάν δεν παρέχεται, θα δημιουργηθεί αυτόματα μέσω ανταλλαγής διακριτικών.
- options
- ToolOptions
Προαιρετικές επιλογές εργαλείου κατά την κλήση της πύλης.
Επιστροφές
Promise<MCPServerConfig[]>
Μια υπόσχεση που επιλύεται σε έναν πίνακα ομαλοποιημένων αντικειμένων ρύθμισης παραμέτρων διακομιστή MCP.
sendChatHistory(TurnContext, ChatHistoryMessage[])
Στέλνει ιστορικό συνομιλίας στην πλατφόρμα MCP για προστασία από απειλές σε πραγματικό χρόνο.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>Παράμετροι
- turnContext
- TurnContext
Το περιβάλλον στροφής που περιέχει πληροφορίες συνομιλίας.
- chatHistoryMessages
Τα μηνύματα ιστορικού συνομιλίας προς αποστολή.
Επιστροφές
Promise<OperationResult>
Μια υπόσχεση που επιλύθηκε σε ένα OperationResult που υποδεικνύει επιτυχία ή αποτυχία.
Παρατηρήσεις
Οι εξαιρέσεις HTTP (σφάλματα δικτύου, χρονικά όρια) καταγράφονται και καταγράφονται, αλλά δεν εμφανίζονται ξανά. Αντί για αυτό, η μέθοδος επιστρέφει ένα OperationResult που υποδεικνύει εάν η λειτουργία ολοκληρώθηκε με επιτυχία ή αποτυχία. Οι καλούντες μπορούν να επιλέξουν να ελέγξουν το αποτέλεσμα για χειρισμό σφαλμάτων ή να το αγνοήσουν εάν δεν απαιτούνται λεπτομέρειες σφάλματος.
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)
Στέλνει ιστορικό συνομιλίας στην πλατφόρμα MCP για προστασία από απειλές σε πραγματικό χρόνο.
function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>Παράμετροι
- turnContext
- TurnContext
Το περιβάλλον στροφής που περιέχει πληροφορίες συνομιλίας.
- chatHistoryMessages
Τα μηνύματα ιστορικού συνομιλίας προς αποστολή.
- options
- ToolOptions
Προαιρετικές επιλογές εργαλείων για την αποστολή ιστορικού συνομιλίας.
Επιστροφές
Promise<OperationResult>
Μια υπόσχεση που επιλύθηκε σε ένα OperationResult που υποδεικνύει επιτυχία ή αποτυχία.
Παρατηρήσεις
Οι εξαιρέσεις HTTP (σφάλματα δικτύου, χρονικά όρια) καταγράφονται και καταγράφονται, αλλά δεν εμφανίζονται ξανά. Αντί για αυτό, η μέθοδος επιστρέφει ένα OperationResult που υποδεικνύει εάν η λειτουργία ολοκληρώθηκε με επιτυχία ή αποτυχία. Οι καλούντες μπορούν να επιλέξουν να ελέγξουν το αποτέλεσμα για χειρισμό σφαλμάτων ή να το αγνοήσουν εάν δεν απαιτούνται λεπτομέρειες σφάλματος.