VoiceAgentMcpTool interface
语音代理可用的MCP工具。 服务器端点使用 server_url;不支持连接器和隧道标识符。
属性
| allowed_callers | 调用者可能会调用由该MCP服务器暴露的工具。 |
| allowed_tools | 决定MCP服务器中哪些工具对语音代理开放的工具名称或过滤器。 |
| authorization | OAuth 访问令牌可用于远程 MCP 服务器,可自定义 MCP 服务器 URL 或服务连接器。 你的应用程序必须处理OAuth授权流程,并在这里提供令牌。 |
| defer_loading | 该MCP工具是否被推迟并通过工具搜索发现。 |
| headers | HTTP头用于发送给MCP服务器的请求。 |
| project_connection_id | MCP 服务器的project中的连接 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
OAuth 访问令牌可用于远程 MCP 服务器,可自定义 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
MCP 服务器的project中的连接 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、 connector_id或 tunnel_id 。
server_url?: string
属性值
string
tool_configs
Deprecated. 该属性已被弃用,未来版本中将被移除。
tool_configs?: Record<string, ToolConfig>
属性值
Record<string, ToolConfig>
type
工具类型。 总是 mcp 针对MCP服务器暴露的工具。
type: "mcp"
属性值
"mcp"