McpToolServerConfigurationService class

แพคเกจ:

@microsoft/agents-a365-tooling

บริการที่รับผิดชอบในการค้นหาและลดความซ้ําซ้อนของเซิร์ฟเวอร์เครื่องมือ MCP (Model Context Protocol) และทําให้ออบเจ็กต์การกําหนดค่าสามารถใช้งานโดย Claude SDK ได้

ผู้ผลิต

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

สร้าง McpToolServerConfigurationService

วิธีการ

getMcpClientTools(string, MCPServerConfig)	เชื่อมต่อไปยังเซิร์ฟเวอร์ MCP และส่งกลับเครื่องมือที่มีชื่อนําหน้าด้วยชื่อเซิร์ฟเวอร์ โยนหาก URL ของเซิร์ฟเวอร์หายไปหรือไคลเอ็นต์ล้มเหลวในการทํารายการเครื่องมือ
listToolServers(string, string)	ส่งกลับข้อกําหนดของเซิร์ฟเวอร์ MCP สําหรับตัวแทนที่กําหนด ในการพัฒนา (NODE_ENV=การพัฒนา) สิ่งนี้อ่าน ToolingManifest.jsonภายในเครื่อง มิฉะนั้นจะคิวรีเกตเวย์ของเครื่องมือระยะไกล
listToolServers(string, string, ToolOptions)	ส่งกลับข้อกําหนดของเซิร์ฟเวอร์ MCP สําหรับตัวแทนที่กําหนด ในการพัฒนา (NODE_ENV=การพัฒนา) สิ่งนี้อ่าน ToolingManifest.jsonภายในเครื่อง มิฉะนั้นจะคิวรีเกตเวย์ของเครื่องมือระยะไกล
listToolServers(TurnContext, Authorization, string, string, ToolOptions)	ส่งกลับข้อกําหนดของเซิร์ฟเวอร์ MCP สําหรับตัวแทนที่กําหนด ในการพัฒนา (NODE_ENV=การพัฒนา) สิ่งนี้อ่าน ToolingManifest.jsonภายในเครื่อง มิฉะนั้นจะคิวรีเกตเวย์ของเครื่องมือระยะไกล การโอเวอร์โหลดนี้จะแก้ไข agenticAppId โดยอัตโนมัติจาก TurnContext และสร้างโทเค็นการรับรองความถูกต้องถ้าไม่มี
sendChatHistory(TurnContext, ChatHistoryMessage[])	ส่งประวัติการแชทไปยังแพลตฟอร์ม MCP เพื่อการป้องกันภัยคุกคามแบบเรียลไทม์
sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)	ส่งประวัติการแชทไปยังแพลตฟอร์ม MCP เพื่อการป้องกันภัยคุกคามแบบเรียลไทม์

รายละเอียดคอนสตรักเตอร์

McpToolServerConfigurationService(IConfigurationProvider<ToolingConfiguration>)

สร้าง McpToolServerConfigurationService

new McpToolServerConfigurationService(configProvider?: IConfigurationProvider<ToolingConfiguration>)

พารามิเตอร์

configProvider

IConfigurationProvider<ToolingConfiguration>

ตัวให้บริการการกําหนดค่าทางเลือก ค่าเริ่มต้นเป็น defaultToolingConfigurationProvider ถ้าไม่ได้ระบุ

รายละเอียดวิธีการ

getMcpClientTools(string, MCPServerConfig)

เชื่อมต่อไปยังเซิร์ฟเวอร์ MCP และส่งกลับเครื่องมือที่มีชื่อนําหน้าด้วยชื่อเซิร์ฟเวอร์ โยนหาก URL ของเซิร์ฟเวอร์หายไปหรือไคลเอ็นต์ล้มเหลวในการทํารายการเครื่องมือ

function getMcpClientTools(mcpServerName: string, mcpServerConfig: MCPServerConfig): Promise<McpClientTool[]>

พารามิเตอร์

mcpServerName

string

mcpServerConfig

MCPServerConfig

การส่งคืน

Promise<McpClientTool[]>

listToolServers(string, string)

คำเตือน

API นี้ถูกเลิกใช้แล้วในตอนนี้

Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.

ส่งกลับข้อกําหนดของเซิร์ฟเวอร์ MCP สําหรับตัวแทนที่กําหนด ในการพัฒนา (NODE_ENV=การพัฒนา) สิ่งนี้อ่าน ToolingManifest.jsonภายในเครื่อง มิฉะนั้นจะคิวรีเกตเวย์ของเครื่องมือระยะไกล

function listToolServers(agenticAppId: string, authToken: string): Promise<MCPServerConfig[]>

พารามิเตอร์

agenticAppId

string

ID แอปตัวแทนที่จะค้นหาเซิร์ฟเวอร์

authToken

string

โทเค็นแบเรอร์ที่ใช้เมื่อทําการคิวรีเกตเวย์เครื่องมือระยะไกล

การส่งคืน

Promise<MCPServerConfig[]>

สัญญาในการแก้ไขอาร์เรย์ของออบเจ็กต์การกําหนดค่าเซิร์ฟเวอร์ MCP ที่ปกติ

listToolServers(string, string, ToolOptions)

คำเตือน

API นี้ถูกเลิกใช้แล้วในตอนนี้

Use the overload with TurnContext and Authorization parameters instead to enable x-ms-agentid header support and automatic token generation.

ส่งกลับข้อกําหนดของเซิร์ฟเวอร์ MCP สําหรับตัวแทนที่กําหนด ในการพัฒนา (NODE_ENV=การพัฒนา) สิ่งนี้อ่าน ToolingManifest.jsonภายในเครื่อง มิฉะนั้นจะคิวรีเกตเวย์ของเครื่องมือระยะไกล

function listToolServers(agenticAppId: string, authToken: string, options?: ToolOptions): Promise<MCPServerConfig[]>

พารามิเตอร์

agenticAppId

string

ID แอปตัวแทนที่จะค้นหาเซิร์ฟเวอร์

authToken

string

โทเค็นแบเรอร์ที่ใช้เมื่อทําการคิวรีเกตเวย์เครื่องมือระยะไกล

options

ToolOptions

ตัวเลือกเครื่องมือทางเลือกเมื่อเรียกใช้เกตเวย์

การส่งคืน

Promise<MCPServerConfig[]>

สัญญาในการแก้ไขอาร์เรย์ของออบเจ็กต์การกําหนดค่าเซิร์ฟเวอร์ MCP ที่ปกติ

listToolServers(TurnContext, Authorization, string, string, ToolOptions)

ส่งกลับข้อกําหนดของเซิร์ฟเวอร์ MCP สําหรับตัวแทนที่กําหนด ในการพัฒนา (NODE_ENV=การพัฒนา) สิ่งนี้อ่าน ToolingManifest.jsonภายในเครื่อง มิฉะนั้นจะคิวรีเกตเวย์ของเครื่องมือระยะไกล การโอเวอร์โหลดนี้จะแก้ไข agenticAppId โดยอัตโนมัติจาก TurnContext และสร้างโทเค็นการรับรองความถูกต้องถ้าไม่มี

function listToolServers(turnContext: TurnContext, authorization: Authorization, authHandlerName: string, authToken?: string, options?: ToolOptions): Promise<MCPServerConfig[]>

พารามิเตอร์

turnContext

TurnContext

TurnContext ของคําขอปัจจุบัน

authorization

Authorization

ออบเจ็กต์การตรวจสอบสําหรับการแลกเปลี่ยนโทเค็น

authHandlerName

string

ชื่อของตัวจัดการการรับรองความถูกต้องเพื่อใช้สําหรับการแลกเปลี่ยนโทเค็น

authToken

string

โทเค็นแบเรอร์ทางเลือก ถ้าไม่มี จะมีการสร้างโดยอัตโนมัติผ่านการแลกเปลี่ยนโทเค็น

options

ToolOptions

ตัวเลือกเครื่องมือทางเลือกเมื่อเรียกใช้เกตเวย์

การส่งคืน

Promise<MCPServerConfig[]>

สัญญาในการแก้ไขอาร์เรย์ของออบเจ็กต์การกําหนดค่าเซิร์ฟเวอร์ MCP ที่ปกติ

sendChatHistory(TurnContext, ChatHistoryMessage[])

ส่งประวัติการแชทไปยังแพลตฟอร์ม MCP เพื่อการป้องกันภัยคุกคามแบบเรียลไทม์

function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[]): Promise<OperationResult>

พารามิเตอร์

turnContext

TurnContext

เปลี่ยนบริบทที่ประกอบด้วยข้อมูลการสนทนา

chatHistoryMessages

ChatHistoryMessage[]

ข้อความประวัติการแชทที่จะส่ง

การส่งคืน

Promise<OperationResult>

คําสัญญาที่แก้ไขในการ OperationResult ที่ระบุความสําเร็จหรือความล้มเหลว

หมายเหตุ

ข้อยกเว้น HTTP (ข้อผิดพลาดเครือข่าย การหมดเวลา) จะถูกจับและบันทึกแต่ไม่ถูกเปลี่ยนชื่อ แต่วิธีการ ส่งกลับ OperationResult ที่ระบุว่าการดําเนินการสําเร็จ หรือล้มเหลว ผู้เรียกสามารถเลือกที่จะตรวจสอบผลลัพธ์สําหรับการจัดการข้อผิดพลาด หรือละเว้นถ้าไม่จําเป็นต้องมีรายละเอียดข้อผิดพลาด

sendChatHistory(TurnContext, ChatHistoryMessage[], ToolOptions)

ส่งประวัติการแชทไปยังแพลตฟอร์ม MCP เพื่อการป้องกันภัยคุกคามแบบเรียลไทม์

function sendChatHistory(turnContext: TurnContext, chatHistoryMessages: ChatHistoryMessage[], options?: ToolOptions): Promise<OperationResult>

พารามิเตอร์

turnContext

TurnContext

เปลี่ยนบริบทที่ประกอบด้วยข้อมูลการสนทนา

chatHistoryMessages

ChatHistoryMessage[]

ข้อความประวัติการแชทที่จะส่ง

options

ToolOptions

ตัวเลือกเครื่องมือทางเลือกสําหรับการส่งประวัติการแชท

การส่งคืน

Promise<OperationResult>

คําสัญญาที่แก้ไขในการ OperationResult ที่ระบุความสําเร็จหรือความล้มเหลว

หมายเหตุ

ข้อยกเว้น HTTP (ข้อผิดพลาดเครือข่าย การหมดเวลา) จะถูกจับและบันทึกแต่ไม่ถูกเปลี่ยนชื่อ แต่วิธีการ ส่งกลับ OperationResult ที่ระบุว่าการดําเนินการสําเร็จ หรือล้มเหลว ผู้เรียกสามารถเลือกที่จะตรวจสอบผลลัพธ์สําหรับการจัดการข้อผิดพลาด หรือละเว้นถ้าไม่จําเป็นต้องมีรายละเอียดข้อผิดพลาด