McpToolRegistrationService คลาส

ให้บริการการลงทะเบียนเครื่องมือ MCP สําหรับตัวแทนตัวแทนเฟรมเวิร์ก

บริการนี้จัดการการลงทะเบียนและการจัดการของเซิร์ฟเวอร์เครื่องมือ MCP (Model Context Protocol) ด้วยตัวแทน Agent Framework

คอนสตรักเตอร์

McpToolRegistrationService()

พารามิเตอร์

ชื่อ	คำอธิบาย
logger	Default value: None

วิธีการ

__init__	เตรียมใช้งานบริการการลงทะเบียนเครื่องมือ MCP สําหรับเฟรมเวิร์กตัวแทน
__new__
add_tool_servers_to_agent	เพิ่มเซิร์ฟเวอร์เครื่องมือ MCP ไปยัง RawAgent (มิเรอร์ .NET implementation)
cleanup	ล้างข้อมูลใดๆ ที่บริการใช้
send_chat_history_from_store	ส่งประวัติการแชทจาก HistoryProvider ไปยังแพลตฟอร์ม MCP นี่คือวิธีการที่สะดวกที่แยกข้อความจากร้านค้าและผู้รับมอบสิทธิ์ไปยัง send_chat_history_messages()
send_chat_history_messages	ส่งข้อความประวัติการแชทไปยังแพลตฟอร์ม MCP เพื่อการป้องกันภัยคุกคามแบบเรียลไทม์ นี่คือวิธีการนําไปใช้หลักที่จัดการการแปลงข้อความและการมอบหมายไปยังบริการเครื่องมือหลัก Note แม้ว่า 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 implementation)

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

นี่คือวิธีการที่สะดวกที่แยกข้อความจากร้านค้าและผู้รับมอบสิทธิ์ไปยัง 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 เพื่อการป้องกันภัยคุกคามแบบเรียลไทม์

นี่คือวิธีการนําไปใช้หลักที่จัดการการแปลงข้อความและการมอบหมายไปยังบริการเครื่องมือหลัก

Note

แม้ว่า 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")