MCPToolboxTool interface

套件:
@azure/ai-projects

一個存放在工具箱中的 MCP 工具。

Extends
ToolboxTool

屬性

allowed_callers
allowed_tools
authorization

一種可與遠端 MCP 伺服器共用的 OAuth 存取權杖，可透過自訂 MCP 伺服器 URL 或服務連接器。 你的應用程式必須處理 OAuth 授權流程，並在此提供令牌。
connector_id

服務連接器的識別碼，例如 ChatGPT 中的連接器。 必須提供其中一項 server_url、 connector_id或 tunnel_id 。 在此了解更多關於服務 連接器的資訊。 目前支援 connector_id 的數值有：

  • Dropbox 功能： connector_dropbox
  • Gmail： connector_gmail
  • Google 行事曆： connector_googlecalendar
  • Google 雲端硬碟： connector_googledrive
  • Microsoft Teams：connector_microsoftteams
  • Outlook 日曆：connector_outlookcalendar
  • Outlook 電子郵件：connector_outlookemail
  • SharePoint：connector_sharepoint
defer_loading

是否會將此 MCP 工具延遲或透過工具搜尋發現。
headers
project_connection_id

project 中 MCP 伺服器的連線 ID。 連線會儲存連線至 MCP 伺服器所需的驗證和其他連線詳細資料。
require_approval
server_description

MCP 伺服器的可選描述，用以提供更多背景說明。
server_label

此 MCP 伺服器的標籤，用來在工具呼叫中識別它。
server_url

MCP 伺服器的 URL。 必須提供其中一項 server_url、 connector_id或 tunnel_id 。
tunnel_id

用 Secure MCP 隧道 ID 代替直接伺服器 URL。 必須提供其中一項 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

一種可與遠端 MCP 伺服器共用的 OAuth 存取權杖，可透過自訂 MCP 伺服器 URL 或服務連接器。 你的應用程式必須處理 OAuth 授權流程，並在此提供令牌。

authorization?: string

屬性值

string

connector_id

服務連接器的識別碼，例如 ChatGPT 中的連接器。 必須提供其中一項 server_url、 connector_id或 tunnel_id 。 在此了解更多關於服務 連接器的資訊。 目前支援 connector_id 的數值有：

  • Dropbox 功能： connector_dropbox
  • Gmail： connector_gmail
  • Google 行事曆： connector_googlecalendar
  • Google 雲端硬碟： 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

是否會將此 MCP 工具延遲或透過工具搜尋發現。

defer_loading?: boolean

屬性值

boolean

headers 

headers?: Record<string, string>

屬性值

Record<string, string>

project_connection_id

project 中 MCP 伺服器的連線 ID。 連線會儲存連線至 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 伺服器的 URL。 必須提供其中一項 server_url、 connector_id或 tunnel_id 。

server_url?: string

屬性值

string

tunnel_id

用 Secure MCP 隧道 ID 代替直接伺服器 URL。 必須提供其中一項 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