McpToolRegistrationService Κλάση

Παρέχει υπηρεσίες εγγραφής εργαλείων MCP για τους υπαλλήλους του agent Framework.

Αυτή η υπηρεσία χειρίζεται την εγγραφή και τη διαχείριση των διακομιστών εργαλείων MCP (Model Context Protocol) με τους υπαλλήλους του Agent Framework.

Κατασκευή

McpToolRegistrationService()

Παράμετροι

Όνομα	Περιγραφή
logger	Default value: None

Μέθοδοι

__init__	Προετοιμάστε την υπηρεσία καταχώρησης εργαλείου MCP για το πλαίσιο παράγοντα.
__new__
add_tool_servers_to_agent	Προσθέστε διακομιστές εργαλείων MCP σε μια έκδοση RawAgent (υλοποίηση κατοπτρικών .NET).
cleanup	Κάντε εκκαθάριση τυχόν πόρων που χρησιμοποιούνται από την υπηρεσία.
send_chat_history_from_store	Αποστολή ιστορικού συνομιλίας από ένα HistoryProvider στην πλατφόρμα MCP. Αυτή είναι μια μέθοδος ευκολίας που εξάγει μηνύματα από το store και αναθέτει σε send_chat_history_messages().
send_chat_history_messages	Στείλτε μηνύματα ιστορικού συνομιλίας στην πλατφόρμα MCP για προστασία από απειλές σε πραγματικό χρόνο. Αυτή είναι η κύρια μέθοδος υλοποίησης που χειρίζεται τη μετατροπή μηνυμάτων και την ανάθεση στην υπηρεσία βασικών εργαλείων. Σημείωμα Ακόμη και αν chat_messages είναι κενή ή όλα τα μηνύματα φιλτράρονται κατά τη διάρκεια μετατροπή, η αίτηση θα εξακολουθήσει να αποστέλλεται στην πλατφόρμα MCP. Αυτός ο εξασφαλίζει ότι το μήνυμα χρήστη από το turn_context.activity.text έχει καταχωρηθεί σωστά για προστασία από απειλές σε πραγματικό χρόνο.

__init__

Προετοιμάστε την υπηρεσία καταχώρησης εργαλείου MCP για το πλαίσιο παράγοντα.

__init__(logger: Logger | None = None)

Παράμετροι

Όνομα	Περιγραφή
logger	Logger | None Παρουσία αρχείου καταγραφής για λειτουργίες καταγραφής. Default value: None

__new__

__new__(**kwargs)

add_tool_servers_to_agent

Προσθέστε διακομιστές εργαλείων MCP σε μια έκδοση RawAgent (υλοποίηση κατοπτρικών .NET).

async add_tool_servers_to_agent(chat_client: OpenAIChatClient, agent_instructions: str, initial_tools: List[object], auth: Authorization, auth_handler_name: str, turn_context: TurnContext, auth_token: str | None = None) -> RawAgent

Παράμετροι

Όνομα	Περιγραφή
chat_client Απαιτείται	<xref:OpenAIChatClient> Η παρουσία του προγράμματος-πελάτη συνομιλίας (OpenAIChatClient υποστηρίζει OpenAI και Azure OpenAI)
agent_instructions Απαιτείται	str Οδηγίες για τη συμπεριφορά του παράγοντα
initial_tools Απαιτείται	List[object] Λίστα αρχικών εργαλείων για προσθήκη στον παράγοντα
auth Απαιτείται	<xref:Authorization> Περιβάλλον εξουσιοδότησης για ανταλλαγή διακριτικών
auth_handler_name Απαιτείται	str Το όνομα του χειρισμού εξουσιοδότησης.
turn_context Απαιτείται	<xref:TurnContext> Ενεργοποίηση περιβάλλοντος για τη λειτουργία
auth_token	Optional[str] Προαιρετικό διακριτικό φορέα για έλεγχο ταυτότητας Default value: None

Επιστροφές

Τύπος	Περιγραφή
<xref:RawAgent>	Παρουσία RawAgent με καταχωρημένα εργαλεία MCP.

Εξαιρέσεις

Τύπος	Περιγραφή
Exception	Εάν αποτύχει η δημιουργία παράγοντα.

cleanup

Κάντε εκκαθάριση τυχόν πόρων που χρησιμοποιούνται από την υπηρεσία.

async cleanup()

send_chat_history_from_store

Αποστολή ιστορικού συνομιλίας από ένα HistoryProvider στην πλατφόρμα MCP.

Αυτή είναι μια μέθοδος ευκολίας που εξάγει μηνύματα από το store και αναθέτει σε send_chat_history_messages().

async send_chat_history_from_store(chat_message_store: HistoryProvider, turn_context: TurnContext, tool_options: ToolOptions | None = None) -> OperationResult

Παράμετροι

Όνομα	Περιγραφή
chat_message_store Απαιτείται	<xref:agent_framework._sessions.HistoryProvider> Το HistoryProvider που περιέχει το ιστορικό συνομιλίας.
turn_context Απαιτείται	TurnContext Ορίστε τη στήλη TurnContext από το SDK Αντιπροσώπων που περιέχει πληροφορίες συνομιλίας.
tool_options	ToolOptions | None Προαιρετική ρύθμιση παραμέτρων για την αίτηση. Default value: None

Επιστροφές

Τύπος	Περιγραφή
OperationResult	Το OperationResult υποδεικνύει επιτυχία ή αποτυχία της λειτουργίας.

Εξαιρέσεις

Τύπος	Περιγραφή
ValueError	Εάν chat_message_store ή turn_context είναι Καμία.

Παραδείγματα

>>> service = McpToolRegistrationService()
>>> result = await service.send_chat_history_from_store(
...     thread.chat_message_store, turn_context
... )

send_chat_history_messages

Στείλτε μηνύματα ιστορικού συνομιλίας στην πλατφόρμα MCP για προστασία από απειλές σε πραγματικό χρόνο.

Αυτή είναι η κύρια μέθοδος υλοποίησης που χειρίζεται τη μετατροπή μηνυμάτων και την ανάθεση στην υπηρεσία βασικών εργαλείων.

Σημείωμα

Ακόμη και αν chat_messages είναι κενή ή όλα τα μηνύματα φιλτράρονται κατά τη διάρκεια

μετατροπή, η αίτηση θα εξακολουθήσει να αποστέλλεται στην πλατφόρμα MCP. Αυτός ο

εξασφαλίζει ότι το μήνυμα χρήστη από το turn_context.activity.text έχει καταχωρηθεί

σωστά για προστασία από απειλές σε πραγματικό χρόνο.

async send_chat_history_messages(chat_messages: Sequence[Message], turn_context: TurnContext, tool_options: ToolOptions | None = None) -> OperationResult

Παράμετροι

Όνομα	Περιγραφή
chat_messages Απαιτείται	Sequence[<xref:agent_framework._types.Message>] Ακολουθία αντικειμένων μηνύματος πλαισίου αντιπροσώπων προς αποστολή. Μπορεί να είναι κενή - η αίτηση θα σταλεί για να καταχωρήσει το μήνυμα χρήστη από το turn_context.activity.text.
turn_context Απαιτείται	TurnContext Ορίστε τη στήλη TurnContext από το SDK Αντιπροσώπων που περιέχει πληροφορίες συνομιλίας.
tool_options	ToolOptions | None Προαιρετική ρύθμιση παραμέτρων για την αίτηση. Η προεπιλεγμένη τιμή είναι AgentFramework-συγκεκριμένες επιλογές, εάν δεν παρέχεται. Default value: None

Επιστροφές

Τύπος	Περιγραφή
OperationResult	Το OperationResult υποδεικνύει επιτυχία ή αποτυχία της λειτουργίας.

Εξαιρέσεις

Τύπος	Περιγραφή
ValueError	Εάν chat_messages ή turn_context είναι Καμία.

Παραδείγματα

>>> service = McpToolRegistrationService()
>>> messages = [Message(role="user", text="Hello")]
>>> result = await service.send_chat_history_messages(messages, turn_context)
>>> if result.succeeded:
...     print("Chat history sent successfully")