你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

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调用生成后续响应时, 默认值为 when_idle.

server_description

可选的MCP服务器描述,用于提供更多上下文。

server_label

此 MCP 服务器的标签,用于在工具调用中标识它。

server_url

MCP 服务器的 URL。 必须提供其中一个 server_url、 connector_id或 tunnel_id 。

tool_configs

Deprecated. 该属性已被弃用,未来版本中将被移除。

type

工具类型。 总是 mcp 针对MCP服务器暴露的工具。

属性详细信息

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"