MCPTool class

الحزمة:

@azure/ai-agents

أداة تتصل بخوادم بروتوكول سياق النموذج (MCP). يدعم إدارة اتصالات خادم MCP والأدوات المسموح بها ديناميكيا.

المنشئون

MCPTool(string, string, string[])

يقوم المنشئ بتهيئة الأداة باستخدام تكوين خادم MCP.

الخصائص

allowedTools	احصل على قائمة الأدوات المسموح بها لخادم MCP.
definition	احصل على تعريف أداة MCP.
headers	احصل على رؤوس أداة MCP.
resources	احصل على موارد الأداة للوكيل.
serverLabel	احصل على تسمية الخادم لأداة MCP.
serverUrl	احصل على عنوان URL للخادم لأداة MCP.

الأساليب

allowTool(string)	أضف أداة إلى قائمة الأدوات المسموح بها.
disallowTool(string)	قم بإزالة أداة من قائمة الأدوات المسموح بها.
mergeResources(MCPTool[])	دمج موارد الأداة من مثيلات MCPTool متعددة في كائن ToolResources واحد. يكون هذا مفيدا عند إنشاء تشغيل يجب أن يكون لديه حق الوصول إلى خوادم MCP متعددة في وقت واحد.
setApprovalMode("always" | "never")	قم بتحديث وضع الموافقة لأداة MCP.
updateHeaders(string, string)	قم بتحديث رؤوس أداة MCP.

تفاصيل المنشئ

MCPTool(string, string, string[])

يقوم المنشئ بتهيئة الأداة باستخدام تكوين خادم MCP.

new MCPTool(serverLabel: string, serverUrl: string, allowedTools?: string[])

المعلمات

serverLabel

string

تسمية خادم MCP

serverUrl

string

نقطة النهاية لخادم MCP

allowedTools

string[]

قائمة الأدوات المسموح بها لخادم MCP

تفاصيل الخاصية

allowedTools

احصل على قائمة الأدوات المسموح بها لخادم MCP.

string[] allowedTools

قيمة الخاصية

string[]

definition

احصل على تعريف أداة MCP.

MCPToolDefinition definition

قيمة الخاصية

MCPToolDefinition

قائمة تحتوي على تعريف أداة MCP

headers

احصل على رؤوس أداة MCP.

Record<string, string> headers

قيمة الخاصية

Record<string, string>

resources

احصل على موارد الأداة للوكيل.

ToolResources resources

قيمة الخاصية

ToolResources

serverLabel

احصل على تسمية الخادم لأداة MCP.

string serverLabel

قيمة الخاصية

string

serverUrl

احصل على عنوان URL للخادم لأداة MCP.

string serverUrl

قيمة الخاصية

string

تفاصيل الأسلوب

allowTool(string)

أضف أداة إلى قائمة الأدوات المسموح بها.

function allowTool(toolName: string)

المعلمات

toolName

string

اسم الأداة للسماح

disallowTool(string)

قم بإزالة أداة من قائمة الأدوات المسموح بها.

function disallowTool(toolName: string)

المعلمات

toolName

string

اسم الأداة المراد إزالتها من الأدوات المسموح بها

mergeResources(MCPTool[])

دمج موارد الأداة من مثيلات MCPTool متعددة في كائن ToolResources واحد.

يكون هذا مفيدا عند إنشاء تشغيل يجب أن يكون لديه حق الوصول إلى خوادم MCP متعددة في وقت واحد.

static function mergeResources(mcpTools: MCPTool[]): ToolResources

المعلمات

mcpTools

MCPTool[]

مصفوفة من مثيلات MCPTool التي سيتم دمج مواردها.

المرتجعات

ToolResources

كائن ToolResources يحتوي على جميع موارد أداة MCP من الأدوات المتوفرة.

setApprovalMode("always" | "never")

قم بتحديث وضع الموافقة لأداة MCP.

function setApprovalMode(requireApproval?: "always" | "never")

المعلمات

requireApproval

"always" | "never"

إعداد require_approval للتحديث

updateHeaders(string, string)

قم بتحديث رؤوس أداة MCP.

function updateHeaders(key: string, value: string)

المعلمات

key

string

مفتاح الرأس للتحديث

value

string

القيمة الجديدة لمفتاح الرأس