Utility class

Πακέτο:

@microsoft/agents-a365-tooling

Ιδιότητες

HEADER_AGENT_ID	Όνομα κεφαλίδας για την αποστολή του αναγνωριστικού παράγοντα στην πλατφόρμα MCP για καταγραφή/ανάλυση.
HEADER_CHANNEL_ID
HEADER_SUBCHANNEL_ID
HEADER_USER_AGENT

Μέθοδοι

BuildMcpServerUrl(string, IConfigurationProvider<ToolingConfiguration>)	Δημιουργήστε την πλήρη διεύθυνση URL για πρόσβαση σε έναν συγκεκριμένο διακομιστή MCP. Παράδειγμα: Utility.BuildMcpServerUrl('MyServer') // => "https://agent365.svc.cloud.microsoft/agents/servers/MyServer/"
GetChatHistoryEndpoint(IConfigurationProvider<ToolingConfiguration>)	Κατασκευάζει τη διεύθυνση URL τελικού σημείου για την αποστολή ιστορικού συνομιλίας στην πλατφόρμα MCP για προστασία από απειλές σε πραγματικό χρόνο.
GetMcpBaseUrl(IConfigurationProvider<ToolingConfiguration>)	Λάβετε τη βασική διεύθυνση URL που χρησιμοποιείται για την υποβολή ερωτημάτων σε περιβάλλοντα MCP.
GetToolingGatewayForDigitalWorker(string, IConfigurationProvider<ToolingConfiguration>)	Δημιουργία της διεύθυνσης URL πύλης εργαλείων για μια δεδομένη ταυτότητα παράγοντα. Αυτό το τελικό σημείο χρησιμοποιείται για τον εντοπισμό διακομιστών MCP που σχετίζονται με την ταυτότητα του καθορισμένου παράγοντα. Παράδειγμα: Utility.GetToolingGatewayForDigitalWorker(agenticAppId) // => "https://agent365.svc.cloud.microsoft/agents/v2/{agenticAppId}/mcpServers"
GetToolRequestHeaders(string, TurnContext, ToolOptions)	Σύνταξη τυπικών κεφαλίδων για αιτήσεις εργαλείων MCP. Περιλαμβάνει το διακριτικό φορέα εξουσιοδότησης όταν παρέχεται και περιλαμβάνει προαιρετικά αναγνωριστικά καναλιού και υποκαναίου για δρομολόγηση.
ValidateAuthToken(undefined | string)	Επικυρώνει ένα διακριτικό ελέγχου ταυτότητας 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

IConfigurationProvider<ToolingConfiguration>

Προαιρετική υπηρεσία παροχής ρύθμισης παραμέτρων. Η προεπιλεγμένη τιμή είναι 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

IConfigurationProvider<ToolingConfiguration>

Προαιρετική υπηρεσία παροχής ρύθμισης παραμέτρων. Η προεπιλεγμένη τιμή είναι 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

IConfigurationProvider<ToolingConfiguration>

Προαιρετική υπηρεσία παροχής ρύθμισης παραμέτρων. Η προεπιλεγμένη τιμή είναι 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

IConfigurationProvider<ToolingConfiguration>

Προαιρετική υπηρεσία παροχής ρύθμισης παραμέτρων. Η προεπιλεγμένη τιμή είναι 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 για επικύρωση.