McpToolRegistrationService class

แพคเกจ:

@microsoft/agents-a365-tooling-extensions-openai

ค้นหาเซิร์ฟเวอร์ MCP และเครื่องมือรายการที่จัดรูปแบบสําหรับ SDK ตัวแทน OpenAI ใช้ listToolServers เพื่อดึงการกําหนดค่าเซิร์ฟเวอร์

ผู้ผลิต

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

สร้าง McpToolRegistrationService

วิธีการ

addToolServersToAgent(Agent<unknown, "text">, Authorization, string, TurnContext, string)	ลงทะเบียนเซิร์ฟเวอร์เครื่องมือ MCP และอัปเดตตัวเลือกตัวแทนด้วยเครื่องมือและการกําหนดค่าเซิร์ฟเวอร์ที่ค้นพบ เรียกใช้ฟังก์ชันนี้เพื่อเปิดใช้งานการเข้าถึงเครื่องมือ OpenAI แบบไดนามิกตามสภาพแวดล้อม MCP ปัจจุบัน
sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)	ส่งประวัติการแชทจากเซสชัน OpenAI ไปยังแพลตฟอร์ม MCP สําหรับการป้องกันภัยคุกคามแบบเรียลไทม์ วิธีนี้จะแยกข้อความจากเซสชัน OpenAI ที่ให้มาโดยใช้ getItems()แปลงเป็น ChatHistoryMessage รูปแบบ และส่งไปยังแพลตฟอร์ม MCP ตัวอย่าง const session = new OpenAIConversationsSession(sessionOptions); const result = await service.sendChatHistoryAsync(turnContext, session, 50); if (result.succeeded) { console.log('Chat history sent successfully'); } else { console.error('Failed to send chat history:', result.errors); }
sendChatHistoryMessagesAsync(TurnContext, AgentInputItem[], ToolOptions)	ส่งรายการข้อความ OpenAI ไปยังแพลตฟอร์ม MCP สําหรับการป้องกันภัยคุกคามแบบเรียลไทม์ วิธีนี้แปลงข้อความ AgentInputItem ที่ให้มาเพื่อ ChatHistoryMessage จัดรูปแบบ และส่งไปยังแพลตฟอร์ม MCP ตัวอย่าง const items = await session.getItems(); const result = await service.sendChatHistoryMessagesAsync(turnContext, items);

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

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

สร้าง McpToolRegistrationService

new McpToolRegistrationService(configProvider?: IConfigurationProvider<OpenAIToolingConfiguration>)

พารามิเตอร์

configProvider

IConfigurationProvider<OpenAIToolingConfiguration>

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

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

addToolServersToAgent(Agent<unknown, "text">, Authorization, string, TurnContext, string)

ลงทะเบียนเซิร์ฟเวอร์เครื่องมือ MCP และอัปเดตตัวเลือกตัวแทนด้วยเครื่องมือและการกําหนดค่าเซิร์ฟเวอร์ที่ค้นพบ เรียกใช้ฟังก์ชันนี้เพื่อเปิดใช้งานการเข้าถึงเครื่องมือ OpenAI แบบไดนามิกตามสภาพแวดล้อม MCP ปัจจุบัน

function addToolServersToAgent(agent: Agent<unknown, "text">, authorization: Authorization, authHandlerName: string, turnContext: TurnContext, authToken: string): Promise<Agent<unknown, "text">>

พารามิเตอร์

agent

Agent<unknown, "text">

อินสแตนซ์ของตัวแทน OpenAI ซึ่งจะเพิ่มเซิร์ฟเวอร์ MCP

authorization

Authorization

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

authHandlerName

string

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

turnContext

TurnContext

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

authToken

string

โทเค็นแบเรอร์ทางเลือกสําหรับการเข้าถึงเซิร์ฟเวอร์ MCP

การส่งคืน

Promise<Agent<unknown, "text">>

อินสแตนซ์ของ Agent ที่อัปเดตแล้วด้วยเซิร์ฟเวอร์ MCP ที่ลงทะเบียน

sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

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

วิธีนี้จะแยกข้อความจากเซสชัน OpenAI ที่ให้มาโดยใช้ getItems()แปลงเป็น ChatHistoryMessage รูปแบบ และส่งไปยังแพลตฟอร์ม MCP

ตัวอย่าง

const session = new OpenAIConversationsSession(sessionOptions);
const result = await service.sendChatHistoryAsync(turnContext, session, 50);
if (result.succeeded) {
  console.log('Chat history sent successfully');
} else {
  console.error('Failed to send chat history:', result.errors);
}

function sendChatHistoryAsync(turnContext: TurnContext, session: OpenAIConversationsSession, limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>

พารามิเตอร์

turnContext

TurnContext

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

session

OpenAIConversationsSession

อินสแตนซ์เซสชัน OpenAI ที่จะแยกข้อความออกมา

limit

number

ขีดจํากัดเพิ่มเติมเกี่ยวกับจํานวนข้อความที่จะดึงข้อมูลจากเซสชัน

toolOptions

ToolOptions

ตัวเลือกเครื่องมือทางเลือกสําหรับการกําหนดเอง

การส่งคืน

Promise<OperationResult>

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

sendChatHistoryMessagesAsync(TurnContext, AgentInputItem[], ToolOptions)

ส่งรายการข้อความ OpenAI ไปยังแพลตฟอร์ม MCP สําหรับการป้องกันภัยคุกคามแบบเรียลไทม์

วิธีนี้แปลงข้อความ AgentInputItem ที่ให้มาเพื่อ ChatHistoryMessage จัดรูปแบบ และส่งไปยังแพลตฟอร์ม MCP

ตัวอย่าง

const items = await session.getItems();
const result = await service.sendChatHistoryMessagesAsync(turnContext, items);

function sendChatHistoryMessagesAsync(turnContext: TurnContext, messages: AgentInputItem[], toolOptions?: ToolOptions): Promise<OperationResult>

พารามิเตอร์

turnContext

TurnContext

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

messages

AgentInputItem[]

อาร์เรย์ของข้อความ AgentInputItem ที่จะส่ง

toolOptions

ToolOptions

ตัวเลือกเครื่องมือที่เลือกได้สําหรับการกําหนดเอง

การส่งคืน

Promise<OperationResult>

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