VoiceAgentMcpTool interface

語音代理可用的 MCP 工具。

Extends

屬性

allowed_callers

呼叫者可能會調用由此 MCP 伺服器暴露的工具。

allowed_tools

決定 MCP 伺服器中哪些工具可被語音代理使用的工具名稱或過濾器。

authorization

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

defer_loading

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

headers

HTTP 標頭用於對 MCP 伺服器的請求中。

project_connection_id

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

require_approval

MCP 工具呼叫的核准政策,全球指定或針對特定工具。

response_scheduling

當 MCP 呼叫產生後續回應時, 預設為 when_idle。

server_description

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

server_label

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

server_url

MCP 伺服器的 URL。

tool_configs

Deprecated. 此屬性已廢止,未來版本將被移除。

type

工具類型。 總是 mcp 針對由 MCP 伺服器暴露的工具。

屬性詳細資料

allowed_callers

呼叫者可能會調用由此 MCP 伺服器暴露的工具。

allowed_callers?: CallableToolAllowedCaller[]

屬性值

allowed_tools

決定 MCP 伺服器中哪些工具可被語音代理使用的工具名稱或過濾器。

allowed_tools?: string[] | MCPToolFilter

屬性值

string[] | MCPToolFilter

authorization

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

authorization?: string

屬性值

string

defer_loading

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

defer_loading?: boolean

屬性值

boolean

headers

HTTP 標頭用於對 MCP 伺服器的請求中。

headers?: Record<string, string>

屬性值

Record<string, string>

project_connection_id

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

project_connection_id?: string

屬性值

string

require_approval

MCP 工具呼叫的核准政策,全球指定或針對特定工具。

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

屬性值

MCPToolRequireApproval | "always" | "never"

response_scheduling

當 MCP 呼叫產生後續回應時, 預設為 when_idle。

response_scheduling?: VoiceAgentToolResponseScheduling

屬性值

server_description

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

server_description?: string

屬性值

string

server_label

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

server_label: string

屬性值

string

server_url

MCP 伺服器的 URL。

server_url?: string

屬性值

string

tool_configs

Deprecated. 此屬性已廢止,未來版本將被移除。

tool_configs?: Record<string, ToolConfig>

屬性值

Record<string, ToolConfig>

type

工具類型。 總是 mcp 針對由 MCP 伺服器暴露的工具。

type: "mcp"

屬性值

"mcp"