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 呼叫產生後續回應時, 預設為 |
| server_description | MCP 伺服器的可選描述,用以提供更多背景說明。 |
| server_label | 此 MCP 伺服器的標籤,用來在工具呼叫中識別它。 |
| server_url | MCP 伺服器的 URL。 |
| tool_configs | Deprecated. 此屬性已廢止,未來版本將被移除。 |
| type | 工具類型。 總是 |
屬性詳細資料
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"