McpToolRegistrationService מחלקה

מתן שירותי רישום כלי MCP עבור סוכני Agent Framework.

שירות זה מטפל ברישום ובהנהלה של שרתי כלי MCP (פרוטוקול הקשר מודל) עם נציגי Agent Framework.

בנאי

McpToolRegistrationService()

פרמטרים

שם	תיאור
logger	ערך ברירת מחדל: None

שיטות

__init__	אתחל את שירות רישום כלי MCP עבור Agent Framework.
__new__
add_tool_servers_to_agent	הוסף שרתי כלי MCP ל- RawAgent (שיקוף יישום .NET).
cleanup	נקה את כל המשאבים שבהם משתמש השירות.
send_chat_history_from_store	שלח היסטוריית צ'אט מ- HistoryProvider אל פלטפורמת MCP. זוהי שיטת נוחות שמחלץ הודעות מהחנות ומנציגים ל- send_chat_history_messages().
send_chat_history_messages	שלח הודעות היסטוריית צ'אט אל פלטפורמת MCP להגנה מפני איומים בזמן אמת. זוהי שיטת היישום הראשית המטפלת בהמרת הודעות והקצאה לשירות הליבה של כלי הכלים. הערה גם אם chat_messages ריק או שכל ההודעות מסוננים במהלך ההמרה, הבקשה עדיין תישלח אל פלטפורמת MCP. זה מבטיחה שההודעות מהמשתמש turn_context.activity.text רשומות כראוי עבור הגנה מפני איומים בזמן אמת.

__init__

אתחל את שירות רישום כלי MCP עבור Agent Framework.

__init__(logger: Logger | None = None)

פרמטרים

שם	תיאור
logger	Logger | None מופע הרישום עבור פעולות רישום. ערך ברירת מחדל: 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] אסימון אופציונלי של נושא לאימות ערך ברירת מחדל: None

החזרות

סוג נתונים	תיאור
<xref:RawAgent>	מופע RawAgent עם כלי MCP רשומים.

חריגות

סוג נתונים	תיאור
Exception	אם יצירת סוכן נכשלת.

cleanup

נקה את כל המשאבים שבהם משתמש השירות.

async cleanup()

send_chat_history_from_store

שלח היסטוריית צ'אט מ- HistoryProvider אל פלטפורמת MCP.

זוהי שיטת נוחות שמחלץ הודעות מהחנות ומנציגים ל- 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 תצורה אופציונלית עבור הבקשה. ערך ברירת מחדל: 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 אם לא צוין. ערך ברירת מחדל: 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")