utility Λειτουργική μονάδα

Παρέχει βοηθητικές συναρτήσεις για τα στοιχεία εργαλείων.

Συναρτήσεις

build_mcp_server_url

Κατασκευάζει την πλήρη διεύθυνση URL διακομιστή MCP χρησιμοποιώντας τη διεύθυνση URL βάσης και το όνομα διακομιστή.

build_mcp_server_url(server_name: str) -> str

Παράμετροι

Όνομα	Περιγραφή
server_name Απαιτείται	str Το όνομα του διακομιστή MCP.

Επιστροφές

Τύπος	Περιγραφή
str	Η πλήρης διεύθυνση URL του διακομιστή MCP.

get_chat_history_endpoint

Λαμβάνει τη διεύθυνση URL τελικού σημείου του ιστορικού συνομιλίας για την αποστολή ιστορικού συνομιλίας στην πλατφόρμα MCP.

get_chat_history_endpoint() -> str

Επιστροφές

Τύπος	Περιγραφή
str	Η διεύθυνση URL τελικού σημείου του ιστορικού συνομιλίας.

get_mcp_base_url

Λαμβάνει τη βασική διεύθυνση URL για διακομιστές MCP.

get_mcp_base_url() -> str

Επιστροφές

Τύπος	Περιγραφή
str	Η διεύθυνση URL βάσης για διακομιστές MCP.

get_mcp_platform_authentication_scope

Λαμβάνει την εμβέλεια ελέγχου ταυτότητας της πλατφόρμας MCP.

get_mcp_platform_authentication_scope() -> list[str]

Επιστροφές

Τύπος	Περιγραφή
list[str]	Μια λίστα που περιέχει την κατάλληλη εμβέλεια ελέγχου ταυτότητας πλατφόρμας MCP.

get_tooling_gateway_for_digital_worker

Λαμβάνει τη διεύθυνση URL της πύλης εργαλείων για τον καθορισμένο ψηφιακό εργαζόμενο.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

Παράμετροι

Όνομα	Περιγραφή
agentic_app_id Απαιτείται	str Το αναγνωριστικό agentic app του ψηφιακού εργαζομένου.

Επιστροφές

Τύπος	Περιγραφή
str	Η διεύθυνση URL της πύλης εργαλείων για τον ψηφιακό εργαζόμενο.

is_development_environment

Επιστρέφει την τιμή True εάν το τρέχον περιβάλλον έχει ρυθμιστεί ως ανάπτυξη.

Σειρά επίλυσης (πρώτη μη κενή τιμή κερδίζει):

1. PYTHON_ENVIRONMENT — ρητή μεταβλητή Python SDK που χρησιμοποιείται σε τρέχοντα δείγματα.
2. ENVIRONMENT — μεταβλητή Python SDK παλαιού τύπου (συμβατότητα με προηγούμενες εκδόσεις).
3. ASPNETCORE_ENVIRONMENT — Σύμβαση φιλοξενίας Azure.
4. DOTNET_ENVIRONMENT — σύμβαση γενικού κεντρικού υπολογιστή.
5. Από προεπιλογή, "Development" όταν δεν έχει οριστεί κανένα από τα παραπάνω.

PYTHON_ENVIRONMENT Οι και ENVIRONMENT ελέγχονται πρώτα, έτσι ώστε οι παράγοντες που ορίζουν ENVIRONMENT=Production ρητά να μην επηρεάζονται εάν οριστεί ASPNETCORE_ENVIRONMENTεπίσης μια διαδικασία κεντρικού υπολογιστή .

is_development_environment() -> bool

Επιστροφές

Τύπος	Περιγραφή
bool	True όταν το επιλυμένες περιβάλλον είναι "ανάπτυξη" (χωρίς διάκριση πεζών-κεφαλαίων).

resolve_token_scope_for_server

Επίλυση της εμβέλειας OAuth για αίτηση για έναν συγκεκριμένο διακομιστή MCP.

Οι διακομιστές V2 έχουν το δικό τους ακροατήριο στο audience πεδίο (γυμνή φόρμα GUID ή api:// URI). Όταν παρέχεται ρητή scope τιμή (π.χ. "Tools.ListInvoke.All"), η εμβέλεια είναι {audience}/{scope}. Όταν το εύρος απουσιάζει, {audience}/.default χρησιμοποιείται (βασίζεται σε εμβέλειες με συγκατάθεση εκ των προτέρων). Οι διακομιστές V1 (χωρίς ακροατήριο, το κοινό ισούται με το κοινόχρηστο ATG AppId σε γυμνή φόρμα GUID ή api:// URI) επιστρέφουν πάντα στην κοινόχρηστη εμβέλεια ATG /.default .

resolve_token_scope_for_server(server: MCPServerConfig) -> str

Παράμετροι

Όνομα	Περιγραφή
server Απαιτείται	MCPServerConfig Η ρύθμιση παραμέτρων του διακομιστή MCP για την επίλυση της εμβέλειας για.

Επιστροφές

Τύπος	Περιγραφή
str	Η συμβολοσειρά εμβέλειας OAuth, π.χ. "<guid>/Tools.ListInvoke.All", "api://<guid>/.default"ή το κοινόχρηστο ATG "<atg-guid>/.default".