เพิ่มและจัดการเครื่องมือ

สำคัญ

คุณจําเป็นต้องเป็นส่วนหนึ่งของโปรแกรมการแสดงตัวอย่าง Frontier เพื่อเข้าถึง Microsoft Agent 365 ก่อน Frontier เชื่อมต่อคุณโดยตรงกับนวัตกรรม AI ล่าสุดของ Microsoft การแสดงตัวอย่างในส่วนหน้าจะต้องอยู่ภายใต้ข้อกําหนดการแสดงตัวอย่างที่มีอยู่ของข้อตกลงของลูกค้าของคุณ เนื่องจากคุณลักษณะเหล่านี้ยังคงอยู่ในการพัฒนา ความพร้อมใช้งานและความสามารถของพวกเขาอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป

โมดูล Tooling ช่วยให้นักพัฒนาสามารถค้นหา กําหนดค่า และรวมเซิร์ฟเวอร์ Model Context Protocol (MCP) เข้าไปยังเวิร์กโฟลว์ของบริษัทตัวแทน AI ได้ เซิร์ฟเวอร์ MCP เปิดความสามารถภายนอกเป็นเครื่องมือที่ตัวแทน AI สามารถเรียกใช้ได้ สําหรับภาพรวมของเซิร์ฟเวอร์เครื่องมือที่พร้อมใช้งาน ให้ดู เซิร์ฟเวอร์เครื่องมือ Agent 365

ภาพรวม

การรวม Agent 365 Tooling จะเป็นไปตามเวิร์กโฟลว์สี่ขั้นตอน:

1. กําหนดค่าเซิร์ฟเวอร์ MCP - ใช้ตัวแทน 365 CLI เพื่อค้นหาและเพิ่มเซิร์ฟเวอร์ MCP
2. สร้างรายการ - CLI สร้างขึ้น ToolingManifest.json ด้วยการกําหนดค่าเซิร์ฟเวอร์
3. รวมเข้ากับรหัส - โหลดรายการและลงทะเบียนเครื่องมือกับบริษัท Orchestrator ของคุณ
4. เครื่องมือ เรียก - เรียกใช้เครื่องมือตัวแทนในระหว่างการดําเนินการเพื่อดําเนินการ

ข้อกำหนดเบื้องต้น

ก่อนที่จะกําหนดค่าเซิร์ฟเวอร์ MCP ตรวจสอบให้แน่ใจว่าคุณมี:

• ติดตั้งและกําหนดค่า Agent 365 CLI แล้ว
• .NET 8.0 SDK หรือสูงกว่า - ดาวน์โหลด
• สิทธิ์ของผู้ดูแลระบบส่วนกลางในผู้เช่า Microsoft 365 ของคุณ

การตั้งค่าข้อมูลประจําตัวของตัวแทน

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

ตั้งหลักของบริการ

เรียกใช้สคริปต์การตั้งค่าแบบครั้งเดียวนี้เพื่อสร้างบริการหลักสําหรับเครื่องมือ Agent 365 ในผู้เช่าของคุณ

สำคัญ

นี่คือการดําเนินการครั้งเดียวต่อผู้เช่าที่จําเป็นต้องมีสิทธิ์ผู้ดูแลระบบส่วนกลาง

1. ดาวน์โหลดสคริปต์ New-Agent365ToolsServicePrincipalProdPublic.ps1

2. เปิด PowerShell ในฐานะผู้ดูแลระบบและนําทางไปยังไดเรกทอรีของสคริปต์

3. เรียกใช้สคริปต์ที่:

   .\New-Agent365ToolsServicePrincipalProdPublic.ps1
   

4. ลงชื่อเข้าใช้ด้วยข้อมูลประจําตัว Azure เมื่อได้รับพร้อมท์

หลังจากเสร็จสิ้น ผู้เช่าของคุณพร้อมสําหรับการพัฒนาตัวแทนและการกําหนดค่าเซิร์ฟเวอร์ MCP

กําหนดค่าเซิร์ฟเวอร์ MCP

ใช้ Agent 365 CLI เพื่อค้นหา เพิ่ม และจัดการเซิร์ฟเวอร์ MCP สําหรับตัวแทนของคุณ สําหรับรายการทั้งหมดของเซิร์ฟเวอร์ MCP และความสามารถของพวกเขา ดู แค็ตตาล็อกเซิร์ฟเวอร์ MCP

ค้นหาเซิร์ฟเวอร์ที่พร้อมใช้งาน

แสดงเซิร์ฟเวอร์ MCP ทั้งหมดที่สามารถกําหนดค่าได้:

a365 develop list-available

เพิ่มเซิร์ฟเวอร์ MCP

เพิ่มอย่างน้อยหนึ่งเซิร์ฟเวอร์ MCP ลงในการกําหนดค่าเอเจนต์ของคุณ:

a365 develop add-mcp-servers mcp_MailTools

แสดงรายการเซิร์ฟเวอร์ที่กําหนดค่าไว้

ดูเซิร์ฟเวอร์ MCP ที่กําหนดค่าไว้ในขณะนี้:

a365 develop list-configured

ลบเซิร์ฟเวอร์ MCP ออก

ลบเซิร์ฟเวอร์ MCP ออกจากการกําหนดค่าของคุณ:

a365 develop remove-mcp-servers mcp_MailTools

สําหรับการอ้างอิง CLI ที่สมบูรณ์ โปรดดู คําสั่งพัฒนา a365

ทําความเข้าใจเกี่ยวกับรายการเครื่องมือ

เมื่อคุณเรียกใช้ a365 develop add-mcp-serversCLI จะสร้างไฟล์ที่มี ToolingManifest.json การกําหนดค่าสําหรับเซิร์ฟเวอร์ MCP ทั้งหมด รันไทม์ของเอเจนต์ใช้รายชื่อแฟ้มนี้เพื่อทําความเข้าใจว่าเซิร์ฟเวอร์ใดพร้อมใช้งานและวิธีการรับรองความถูกต้องกับเซิร์ฟเวอร์เหล่านั้น

โครงสร้างรายชื่อแฟ้ม

ตัวอย่าง: ToolingManifest.json

{
  "mcpServers": [
    {
      "mcpServerName": "mcp_MailTools",
      "mcpServerUniqueName": "mcp_MailTools",
      "scope": "McpServers.Mail.All",
      "audience": "api://05879165-0320-489e-b644-f72b33f3edf0"
    }
  ]
}

พารามิเตอร์รายชื่อแฟ้ม

รายการเซิร์ฟเวอร์ MCP แต่ละรายการประกอบด้วย:

พารามิเตอร์	คำอธิบาย
mcpServerName	ชื่อที่แสดงของสินทรัพย์
mcpServerUniqueName	รหัสเฉพาะสําหรับอินสแตนซ์ของเซิร์ฟเวอร์ MCP
ขอบเขต	ขอบเขต OAuth จําเป็นสําหรับการเข้าถึงความสามารถของเซิร์ฟเวอร์ MCP (ตัวอย่างเช่น: McpServers.Mail.All สําหรับการดําเนินการทางจดหมาย) ค่านี้จะถูกดึงมาจากแค็ตตาล็อกเซิร์ฟเวอร์ MCP เมื่อคุณเรียกใช้ add-mcp-servers คําสั่ง
ผู้ชม	Microsoft Entra ID URI ที่ระบุทรัพยากร API เป้าหมาย ค่านี้จะถูกดึงมาจากแค็ตตาล็อกเซิร์ฟเวอร์ MCP ด้วย

หมายเหตุ

ค่า scope และ audience จะถูกเติมโดย Agent 365 CLI โดยอัตโนมัติเมื่อคุณเพิ่มเซิร์ฟเวอร์ MCP ค่าเหล่านี้มาจาก แค็ตตาล็อก เซิร์ฟเวอร์ MCP และกําหนดสิทธิ์ที่จําเป็นในการเข้าถึงเซิร์ฟเวอร์ MCP แต่ละตัว

รวมเครื่องมือลงในตัวแทนของคุณ

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

เซิร์ฟเวอร์เครื่องมือรายการ (ไม่บังคับ)

เคล็ดลับ

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

ใช้บริการการกําหนดค่าเซิร์ฟเวอร์เครื่องมือเพื่อค้นหาว่าเซิร์ฟเวอร์เครื่องมือใดที่พร้อมใช้งานสําหรับตัวแทนของคุณจากรายการการกําหนดค่าเครื่องมือ วิธีนี้ช่วยให้คุณสามารถ:

• สอบถามเซิร์ฟเวอร์ MCP ที่กําหนดค่าทั้งหมดจาก ToolingManifest.json
• เรียกใช้เมตาดาต้าและความสามารถของเซิร์ฟเวอร์
• ตรวจสอบความพร้อมใช้งานของเซิร์ฟเวอร์ก่อนการลงทะเบียน

วิธีการแสดงรายการเซิร์ฟเวอร์เครื่องมือจะพร้อมใช้งานในแพคเกจเครื่องมือหลัก:

หลาม

# Use McpToolServerConfigurationService.list_tool_servers
from microsoft.agents.a365.tooling import McpToolServerConfigurationService

config_service = McpToolServerConfigurationService()
tool_servers = await config_service.list_tool_servers(agentic_app_id, auth_token)

พารามิเตอร์

พารามิเตอร์	ชนิด	รายละเอียด	ค่าที่คาดหวัง	จำเป็น/ไม่จำเป็นต้องระบุ
agentic_app_id	str	รหัสเฉพาะสําหรับอินสแตนซ์ของแอปพลิเคชันตัวแทน	สตริง ID แอปพลิเคชันของตัวแทนที่ถูกต้อง	ต้องมี
auth_token	str	โทเค็นแบเรอร์สําหรับการรับรองความถูกต้องกับเกตเวย์เซิร์ฟเวอร์ MCP	โทเค็นแบเรอร์ OAuth ที่ถูกต้อง	ต้องมี

แพคเกจ: microsoft-agents-a365-tooling

JavaScript

// Use McpToolServerConfigurationService.listToolServers
const { McpToolServerConfigurationService } = require('@microsoft/agents-a365-tooling');

const configService = new McpToolServerConfigurationService();
const toolServers = await configService.listToolServers(agentUserId, authToken);

พารามิเตอร์

พารามิเตอร์	ชนิด	รายละเอียด	ค่าที่คาดหวัง	จำเป็น/ไม่จำเป็นต้องระบุ
agentInstanceId	สตริง	รหัสเฉพาะสําหรับอินสแตนซ์ของตัวแทน	สตริง ID อินสแตนซ์ของตัวแทนที่ถูกต้อง	ต้องมี
authToken	สตริง	โทเค็นแบเรอร์สําหรับการรับรองความถูกต้องกับเกตเวย์เซิร์ฟเวอร์ MCP	โทเค็นแบเรอร์ OAuth ที่ถูกต้อง	ต้องมี

แพคเกจ: Microsoft.Agents.A365.Tooling

ตาข่าย

// Use IMcpToolServerConfigurationService.ListToolServersAsync
using Microsoft.Agents.A365.Tooling.Services;

var configService = serviceProvider.GetRequiredService<IMcpToolServerConfigurationService>();
var toolServers = await configService.ListToolServersAsync(agentInstanceId, authToken);

พารามิเตอร์

พารามิเตอร์	ชนิด	รายละเอียด	ค่าที่คาดหวัง	จำเป็น/ไม่จำเป็นต้องระบุ
agentInstanceId	สตริง	รหัสเฉพาะสําหรับอินสแตนซ์ของตัวแทน	สตริง ID อินสแตนซ์ของตัวแทนที่ถูกต้อง	ต้องมี
authToken	สตริง	โทเค็นแบเรอร์สําหรับการรับรองความถูกต้องกับเกตเวย์เซิร์ฟเวอร์ MCP	โทเค็นแบเรอร์ OAuth ที่ถูกต้อง	ต้องมี

แพคเกจ: Microsoft.Agents.A365.Tooling

ลงทะเบียนเครื่องมือกับบริษัท Orchestrator ของคุณ

ใช้เมธอดส่วนขยายเฉพาะเฟรมเวิร์กเพื่อลงทะเบียนเซิร์ฟเวอร์ MCP ทั้งหมดด้วยเฟรมเวิร์กการเรียงของคุณ:

• AddToolServersToAgentAsync (.NET)
• add_tool_servers_to_agent (Python)
• addToolServersToAgent (Node.js)

วิธีการเหล่านี้:

• ลงทะเบียนเครื่องมือทั้งหมดจากเซิร์ฟเวอร์ MCP ที่กําหนดค่าไว้กับบริษัท Orchestrator ของคุณ
• ตั้งค่ารายละเอียดการรับรองความถูกต้องและการเชื่อมต่อโดยอัตโนมัติ
• ทําให้เครื่องมือพร้อมใช้งานทันทีสําหรับตัวแทนของคุณที่จะเรียกใช้

เลือกส่วนขยาย orchestrator ของคุณ

โมดูล Agent 365 Tooling มีแพคเกจส่วนขยายเฉพาะสําหรับเฟรมเวิร์กการเรียงลําดับที่แตกต่างกัน:

หลาม

• microsoft-agents-a365-tooling: ฟังก์ชันการทํางานของเครื่องมือหลัก
• microsoft-agents-a365-tooling-extensions-agentframework: การรวม Agent Framework
• microsoft-agents-a365-tooling-extensions-azureaifoundry: การรวม Azure AI Foundry
• microsoft-agents-a365-tooling-extensions-openai: การรวม OpenAI
• microsoft-agents-a365-tooling-extensions-semantickernel: การรวม Kernel ความหมาย

JavaScript

• เครื่องมือ @microsoft/agents-a365: ฟังก์ชันการใช้เครื่องมือหลัก
• @microsoft/agents-a365-tooling-extensions-claude: การรวม Claude
• @microsoft/agents-a365-tooling-extensions-openai: การรวม OpenAI
• @microsoft/agents-a365-tooling-extensions-langchain: การรวม LangChain

ตาข่าย

• Microsoft.Agents.A365.Tooling: ฟังก์ชันการทํางานของเครื่องมือหลัก
• Microsoft.Agents.A365.Tooling.Extensions.AgentFramework: การรวม Agent Framework
• Microsoft.Agents.A365.Tooling.Extensions.AzureAIFoundry: การรวม Azure AI Foundry
• Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel: การรวม Kernel เชิงความหมาย

หมายเหตุ

การรับรองความถูกต้องได้รับการกําหนดค่าโดย Agent 365 CLI โดยอัตโนมัติเมื่อคุณเรียกใช้a365 develop add-mcp-servers ขอบเขต OAuth และค่าผู้ชมจะถูกดึงมาจากแค็ตตาล็อกเซิร์ฟเวอร์ MCP และรวมอยู่ในToolingManifest.json วิธีส่วนขยายจะใช้ค่าเหล่านี้โดยอัตโนมัติเพื่อตั้งค่าการรับรองความถูกต้อง

สําหรับตัวอย่างการใช้งานโดยละเอียด ให้ดูตัวอย่างของตัวแทนที่ 365

ตัวอย่างการใช้งาน

ตัวอย่างต่อไปนี้สาธิตวิธีการรวม Agent 365 Tooling กับเฟรมเวิร์กการเรียงลําดับที่แตกต่างกัน

หลาม

Python พร้อม OpenAI

ตัวอย่างนี้แสดงวิธีการรวมเครื่องมือ MCP กับ OpenAI ในแอปพลิเคชัน Python

เพิ่มคำสั่งนำเข้า

เพิ่มการนําเข้าที่จําเป็นเพื่อเข้าถึงโมดูลการใช้เครื่องมือและส่วนขยาย OpenAI:

from microsoft.agents.a365.tooling import McpToolServerConfigurationService
from microsoft.agents.a365.tooling.extensions.openai import mcp_tool_registration_service

2. เริ่มต้นบริการเครื่องมือ

สร้างอินสแตนซ์ของการกําหนดค่าและบริการลงทะเบียนเครื่องมือ:

# Create configuration service and tool service with dependency injection
self.config_service = McpToolServerConfigurationService()
self.tool_service = mcp_tool_registration_service.McpToolRegistrationService()

3. ลงทะเบียนเครื่องมือ MCP กับตัวแทน OpenAI

ใช้วิธีการลงทะเบียน add_tool_servers_to_agent เครื่องมือ MCP ที่กําหนดค่าทั้งหมดกับตัวแทน OpenAI ของคุณ วิธีนี้จะจัดการสถานการณ์การรับรองความถูกต้องทั้งแบบตัวแทนและแบบไม่มีข้อมูล (nonagentic)

async def setup_mcp_servers(self, auth: Authorization, context: TurnContext):
    """Set up MCP server connections"""
    try:
        use_agentic_auth = os.getenv("USE_AGENTIC_AUTH", "false").lower() == "true"
        if use_agentic_auth:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
            )
        else:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
                auth_token=self.auth_options.bearer_token,
            )

    except Exception as e:
        logger.error(f"Error setting up MCP servers: {e}")

พารามิเตอร์เมธอด

ตารางต่อไปนี้อธิบายพารามิเตอร์ที่ต้องพิจารณา

พารามิเตอร์	คำอธิบาย
agent	อินสแตนซ์ของตัวแทน OpenAI เพื่อลงทะเบียนเครื่องมือ
agentic_app_id	ตัวระบุเฉพาะสําหรับตัวแทน (ID แอปเชิงตัวแทน)
auth	บริบทการรับรองความถูกต้องสําหรับผู้ใช้
context	บริบทการสนทนาปัจจุบันจะเปลี่ยนบริบทจาก SDK ของตัวแทน แสดงข้อมูลประจําตัวของผู้ใช้ เมตาดาต้าการสนทนา และบริบทการรับรองความถูกต้องสําหรับการลงทะเบียนเครื่องมือที่ปลอดภัย
auth_token	(ไม่บังคับ) โทเค็นแบเรอร์สําหรับสถานการณ์การรับรองความถูกต้องที่ไม่ใช่ในเชิงปริมาณ

4. เรียกใช้ในระหว่างการเตรียมใช้งาน

ตรวจสอบให้แน่ใจว่าคุณเรียกใช้เมธอดการตั้งค่าในระหว่างการเตรียมใช้งานก่อนเรียกใช้ตัวแทน:

# Setup MCP servers during initialization
await self.setup_mcp_servers(auth, context)

วิธีการโดยอัตโนมัติ add_tool_servers_to_agent :

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

JavaScript

JavaScript ที่มี LangChain

ตัวอย่างนี้แสดงวิธีการรวมเครื่องมือ MCP กับ LangChain ในแอปพลิเคชัน JavaScript/TypeScript

เพิ่มคำสั่งนำเข้า

เพิ่มการนําเข้าที่จําเป็นเพื่อเข้าถึงโมดูลการใช้เครื่องมือและส่วนขยาย LangChain:

import { McpToolServerConfigurationService } from '@microsoft/agents-a365-tooling';
import { McpToolRegistrationService } from '@microsoft/agents-a365-tooling-extensions-langchain';

2. เริ่มต้นบริการเครื่องมือ

สร้างอินสแตนซ์ของบริการลงทะเบียนเครื่องมือ:

const toolService = new McpToolRegistrationService();

3. ลงทะเบียนเครื่องมือ MCP กับตัวแทน LangChain

ใช้วิธีการลงทะเบียน addToolServersToAgent เครื่องมือ MCP ที่กําหนดค่าทั้งหมดกับตัวแทน LangChain ของคุณ วิธีนี้จะจัดการสถานการณ์การรับรองความถูกต้องทั้งแบบตัวแทนและแบบไม่มีข้อมูล (nonagentic)

// Get MCP Tools
try {
  const agent = await toolService.addToolServersToAgent(
    agent,
    process.env.AGENTIC_USER_ID || '',
    authorization,
    turnContext,
    process.env.MCP_AUTH_TOKEN || "",
  );
} catch (error) {
  console.error('Error adding MCP tool servers:', error);
}

พารามิเตอร์เมธอด

ตารางต่อไปนี้อธิบายพารามิเตอร์เพื่อใช้กับ addToolServersToAgent วิธีการ

พารามิเตอร์	คำอธิบาย
agent	อินสแตนซ์ LangChain ReactAgent เพื่อลงทะเบียนเครื่องมือ
agentUserId	ตัวระบุเฉพาะสำหรับไทล์ สามารถเป็นสตริงว่าง ('') ถ้าไม่ได้ใช้การรับรองความถูกต้องแบบตัวแทน
authorization	บริบทการรับรองความถูกต้องสําหรับผู้ใช้
turnContext	บริบทการสนทนาปัจจุบันจะเปลี่ยนบริบทจาก SDK ของตัวแทน แสดงข้อมูลประจําตัวของผู้ใช้ เมตาดาต้าการสนทนา และบริบทการรับรองความถูกต้องสําหรับการลงทะเบียนเครื่องมือที่ปลอดภัย
authToken	(ไม่บังคับ) โทเค็นแบเรอร์สําหรับสถานการณ์การรับรองความถูกต้องที่ไม่ใช่ในเชิงปริมาณ

4. เรียกใช้ในระหว่างการเตรียมใช้งาน

addToolServersToAgentเรียกใช้เมธอด ระหว่างการเตรียมใช้งานเพื่อลงทะเบียนเครื่องมือ MCP กับตัวแทนของคุณ

วิธีการโดยอัตโนมัติ addToolServersToAgent :

• โหลดเซิร์ฟเวอร์ MCP ทั้งหมดจาก ToolingManifest.json
• ลงทะเบียนเครื่องมือของพวกเขากับตัวแทน LangChain
• ตั้งค่าการรับรองความถูกต้องโดยยึดตามการกําหนดค่ารายชื่อแฟ้ม
• ทําให้เครื่องมือพร้อมใช้งานสําหรับตัวแทนของคุณที่จะเรียกใช้

ตาข่าย

.NET ที่มีเคอร์เนลความหมาย

ตัวอย่างนี้แสดงวิธีการรวมเครื่องมือ MCP กับเคอร์เนลความหมายในแอปพลิเคชัน .NET

เพิ่มคำสั่งนำเข้า

เพิ่ม namespace ที่จําเป็นเพื่อเข้าถึงโมดูล Tooling และส่วนขยาย Kernel ความหมาย:

using Microsoft.Agents.A365.Tooling;
using Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel;

2. ลงทะเบียนบริการด้วยการฉีดขึ้นต่อกัน

เพิ่มบริการการใช้เครื่องมือลงในคอนเทนเนอร์การฉีดแบบขึ้นต่อกันของคุณเพื่อให้สามารถใส่ลงในคลาสของคุณ:

builder.Services.AddSingleton<IMcpToolRegistrationService, McpToolRegistrationService>();
builder.Services.AddSingleton<IMcpToolServerConfigurationService, McpToolServerConfigurationService>();

3.เพิ่มเขตข้อมูลส่วนตัวประกาศ

ประกาศเขตข้อมูลส่วนตัวเพื่อเก็บการอ้างอิงบริการลงทะเบียนเครื่องมือ:

private readonly IMcpToolRegistrationService _toolsService;

4. ลงทะเบียนเครื่องมือ MCP ด้วยเคอร์เนลความหมาย

AddToolServersToAgentAsyncใช้วิธีการขยายเพื่อลงทะเบียนเครื่องมือ MCP ที่กําหนดค่าทั้งหมดด้วยอินสแตนซ์เคอร์เนลความหมายของคุณ วิธีนี้จะจัดการสถานการณ์การรับรองความถูกต้องทั้งแบบตัวแทนและแบบไม่มีข้อมูล (nonagentic)

// Simplified call (authentication configured automatically)
await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, turnContext);

// Or with explicit authentication parameters:
if (useAgenticAuth)
{
    await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, authHandlerName, turnContext);
}
else
{
    await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, authHandlerName, turnContext, authToken);
}

หมายเหตุ

มีโอเวอร์โหลดหลายเมธอด เวอร์ชันที่เรียบง่ายใช้การกําหนดค่าการรับรองความถูกต้องเริ่มต้น ในขณะที่เวอร์ชันที่ชัดเจนอนุญาตข้อกําหนดตัวจัดการการรับรองความถูกต้องแบบกําหนดเอง

พารามิเตอร์เมธอด

ตารางต่อไปนี้อธิบายพารามิเตอร์ที่ต้องพิจารณา

พารามิเตอร์	คำอธิบาย
kernel	อินสแตนซ์เคอร์เนลเชิงความหมายเพื่อลงทะเบียนเครื่องมือด้วย Kernel orchestrates บริการ AI ปลั๊กอิน และการดําเนินการของฟังก์ชัน
userAuthorization	บริบทการรับรองความถูกต้องสําหรับผู้ใช้
authHandlerName	ชื่อตัวจัดการการรับรองความถูกต้องสําหรับใช้กับระบบ UserAuthorization
turnContext	บริบทเปลี่ยนการสนทนาปัจจุบัน (ข้อความผู้ใช้หนึ่งข้อความและวงจรการตอบสนองของตัวแทน) จาก SDK ของตัวแทน แสดงข้อมูลประจําตัวของผู้ใช้ เมตาดาต้าการสนทนา และบริบทการรับรองความถูกต้องสําหรับการลงทะเบียนเครื่องมือที่ปลอดภัย
authToken	(ไม่บังคับ) โทเค็นแบเรอร์สําหรับสถานการณ์การรับรองความถูกต้องนอกเวลา

วิธีการโดยอัตโนมัติ AddToolServersToAgentAsync :

• โหลดเซิร์ฟเวอร์ MCP ทั้งหมดจาก ToolingManifest.json
• ลงทะเบียนเครื่องมือของพวกเขาด้วย Kernel ความหมาย
• ตั้งค่าการรับรองความถูกต้องโดยยึดตามการกําหนดค่ารายชื่อแฟ้ม
• ทําให้เครื่องมือพร้อมใช้งานสําหรับตัวแทนของคุณที่จะเรียกใช้

สําหรับตัวอย่างการทํางานที่เสร็จสมบูรณ์ ให้ดู ที่เก็บตัวอย่างตัวแทน 365

ทดสอบและตรวจสอบ

ทดสอบเอเจนต์ของคุณ

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

เพิ่มความสามารถในการสังเกต

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