MCPToolboxTool interface

الحزمة:

@azure/ai-projects

أداة MCP مخزنة في صندوق أدوات.

يمتد

ToolboxTool

الخصائص

allowed_callers
allowed_tools
authorization	رمز وصول OAuth يمكن استخدامه مع خادم MCP بعيد، إما مع رابط خادم MCP مخصص أو موصل خدمة. يجب أن يتعامل تطبيقك مع تدفق تفويض OAuth ويوفر الرمز هنا.
connector_id	معرف لموصلات الخدمة، مثل تلك المتوفرة في ChatGPT. واحد من server_url، connector_id، أو tunnel_id يجب توفيره. تعرف على المزيد حول موصلات الخدمة هنا. القيم المدعومة connector_id حاليا هي: دروب بوكس: connector_dropbox جيميل: connector_gmail تقويم Google: connector_googlecalendar جوجل درايف: connector_googledrive Microsoft Teams:connector_microsoftteams Outlook التقويم: connector_outlookcalendar Outlook البريد الإلكتروني: connector_outlookemail Sharepoint: connector_sharepoint
defer_loading	هل يتم تأجيل واكتشاف هذه الأداة من خلال البحث عن الأدوات.
headers
project_connection_id	معرف الاتصال في project لخادم MCP. يخزن الاتصال المصادقة وتفاصيل الاتصال الأخرى اللازمة للاتصال بخادم MCP.
require_approval
server_description	وصف اختياري لخادم MCP، يستخدم لتوفير المزيد من السياق.
server_label	تسمية لخادم MCP هذا، تستخدم للتعرف عليه في استدعاءات الأدوات.
server_url	رابط خادم MCP. واحد من server_url، connector_id، أو tunnel_id يجب توفيره.
tunnel_id	معرف نفق MCP الآمن للاستخدام بدلا من رابط خادم مباشر. واحد من server_url، connector_id، أو tunnel_id يجب توفيره.
type	القيم المحتملة للتمييز: code_interpreter، file_search، web_search، mcp، azure_ai_search، openapi، a2a_preview، browser_automation_preview، reminder_preview، work_iq_preview، fabric_iq_preview، toolbox_search_preview، toolbox_search

الخصائص الموروثة

description	وصف اختياري معرف من قبل المستخدم لهذه الأداة أو التكوين.
name	اسم اختياري محدد من قبل المستخدم لهذه الأداة أو التكوين.
tool_configs	خريطة تكوين لكل أداة. المفاتيح هي أسماء أدوات أو * (الافتراضي الشامل). ترتيب الحل: مطابقة اسم الأداة الدقيقة لها الأولوية على *. يتم تجاهل أسماء الأدوات المجهولة بصمت أثناء وقت التشغيل.

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

allowed_callers

allowed_callers?: CallableToolAllowedCaller[]

قيمة الخاصية

CallableToolAllowedCaller[]

allowed_tools

allowed_tools?: string[] | MCPToolFilter

قيمة الخاصية

string[] | MCPToolFilter

authorization

رمز وصول OAuth يمكن استخدامه مع خادم MCP بعيد، إما مع رابط خادم MCP مخصص أو موصل خدمة. يجب أن يتعامل تطبيقك مع تدفق تفويض OAuth ويوفر الرمز هنا.

authorization?: string

قيمة الخاصية

string

connector_id

معرف لموصلات الخدمة، مثل تلك المتوفرة في ChatGPT. واحد من server_url، connector_id، أو tunnel_id يجب توفيره. تعرف على المزيد حول موصلات الخدمة هنا. القيم المدعومة connector_id حاليا هي:

• دروب بوكس: connector_dropbox
• جيميل: connector_gmail
• تقويم Google: connector_googlecalendar
• جوجل درايف: connector_googledrive
• Microsoft Teams:connector_microsoftteams
• Outlook التقويم: connector_outlookcalendar
• Outlook البريد الإلكتروني: connector_outlookemail
• Sharepoint: connector_sharepoint

connector_id?: "connector_dropbox" | "connector_gmail" | "connector_googlecalendar" | "connector_googledrive" | "connector_microsoftteams" | "connector_outlookcalendar" | "connector_outlookemail" | "connector_sharepoint"

قيمة الخاصية

"connector_dropbox" | "connector_gmail" | "connector_googlecalendar" | "connector_googledrive" | "connector_microsoftteams" | "connector_outlookcalendar" | "connector_outlookemail" | "connector_sharepoint"

defer_loading

هل يتم تأجيل واكتشاف هذه الأداة من خلال البحث عن الأدوات.

defer_loading?: boolean

قيمة الخاصية

boolean

headers

headers?: Record<string, string>

قيمة الخاصية

Record<string, string>

project_connection_id

معرف الاتصال في project لخادم MCP. يخزن الاتصال المصادقة وتفاصيل الاتصال الأخرى اللازمة للاتصال بخادم MCP.

project_connection_id?: string

قيمة الخاصية

string

require_approval

require_approval?: MCPToolRequireApproval | "always" | "never"

قيمة الخاصية

MCPToolRequireApproval | "always" | "never"

server_description

وصف اختياري لخادم MCP، يستخدم لتوفير المزيد من السياق.

server_description?: string

قيمة الخاصية

string

server_label

تسمية لخادم MCP هذا، تستخدم للتعرف عليه في استدعاءات الأدوات.

server_label: string

قيمة الخاصية

string

server_url

رابط خادم MCP. واحد من server_url، connector_id، أو tunnel_id يجب توفيره.

server_url?: string

قيمة الخاصية

string

tunnel_id

معرف نفق MCP الآمن للاستخدام بدلا من رابط خادم مباشر. واحد من server_url، connector_id، أو tunnel_id يجب توفيره.

tunnel_id?: string

قيمة الخاصية

string

type

القيم المحتملة للتمييز: code_interpreter، file_search، web_search، mcp، azure_ai_search، openapi، a2a_preview، browser_automation_preview، reminder_preview، work_iq_preview، fabric_iq_preview، toolbox_search_preview، toolbox_search

type: "mcp"

قيمة الخاصية

"mcp"

تفاصيل الخاصية الموروثة

description

وصف اختياري معرف من قبل المستخدم لهذه الأداة أو التكوين.

description?: string

قيمة الخاصية

string

موروث منToolboxTool.description

name

اسم اختياري محدد من قبل المستخدم لهذه الأداة أو التكوين.

name?: string

قيمة الخاصية

string

ورث منToolboxTool.name

tool_configs

خريطة تكوين لكل أداة. المفاتيح هي أسماء أدوات أو * (الافتراضي الشامل). ترتيب الحل: مطابقة اسم الأداة الدقيقة لها الأولوية على *. يتم تجاهل أسماء الأدوات المجهولة بصمت أثناء وقت التشغيل.

tool_configs?: Record<string, ToolConfig>

قيمة الخاصية

Record<string, ToolConfig>

الموروثة منToolboxTool.tool_configs