VoiceAgentMcpTool interface

パッケージ:

@azure/ai-projects

音声エージェントが利用できるMCPツール。

Extends

VoiceAgentTool

プロパティ

allowed_callers	このMCPサーバーが公開したツールを呼び出す可能性のある呼び出し者。
allowed_tools	MCPサーバーからどのツールが音声エージェントに利用可能かを決めるツール名やフィルター。
authorization	リモートMCPサーバーで使用できるOAuthアクセストークンで、カスタムMCPサーバーURLまたはサービスコネクターを使用します。 アプリケーションはOAuth認証フローを処理し、ここでトークンを提供しなければなりません。
defer_loading	このMCPツールが先送りされ、ツール検索によって発見されるかどうか。
headers	MCPサーバーへのリクエストに含まれるHTTPヘッダー。
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。
tool_configs	非推奨。 このプロパティは現在非推奨となり、将来のバージョンで削除される予定です。
type	ツールの種類。 MCPサーバーで公開されたツールは mcp 。

プロパティの詳細

allowed_callers

このMCPサーバーが公開したツールを呼び出す可能性のある呼び出し者。

allowed_callers?: CallableToolAllowedCaller[]

プロパティ値

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

MCPサーバーへのリクエストに含まれるHTTPヘッダー。

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

プロパティ値

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

非推奨。 このプロパティは現在非推奨となり、将来のバージョンで削除される予定です。

tool_configs?: Record<string, ToolConfig>

プロパティ値

Record<string, ToolConfig>

type

ツールの種類。 MCPサーバーで公開されたツールは mcp 。

type: "mcp"

プロパティ値

"mcp"