VoiceAgentMcpTool interface

Package:

@azure/ai-projects

Un outil MCP disponible pour un agent vocal. Les points de terminaison serveur utilisent server_url; les identifiants de connecteur et de tunnel ne sont pas pris en charge.

Extends

VoiceAgentTool

Propriétés

allowed_callers	Les appelants qui peuvent invoquer des outils exposés par ce serveur MCP.
allowed_tools	Les noms d’outils ou le filtre qui déterminent quels outils du serveur MCP sont disponibles pour l’agent vocal.
authorization	Un jeton d’accès OAuth pouvant être utilisé avec un serveur MCP distant, soit avec une URL MCP personnalisée ou un connecteur de service. Votre application doit gérer le flux d’autorisation OAuth et fournir le jeton ici.
defer_loading	Si cet outil MCP est différé et découvert via la recherche d’outils.
headers	Des en-têtes HTTP à inclure dans les requêtes vers le serveur MCP.
project_connection_id	ID de connexion dans le project du serveur MCP. La connexion stocke l’authentification et d’autres détails de connexion nécessaires pour se connecter au serveur MCP.
require_approval	La politique d’approbation pour les appels d’outils MCP, spécifiée globalement ou pour des outils sélectionnés.
response_scheduling	Lorsque l’invocation MCP crée une réponse de suivi. La valeur par défaut est when_idle.
server_description	Description facultative du serveur MCP, utilisée pour fournir davantage de contexte.
server_label	Étiquette de ce serveur MCP, utilisée pour l’identifier dans les appels d’outils.
server_url	URL du serveur MCP. Un de server_url, connector_id, ou tunnel_id doit être fourni.
tool_configs	Deprecated. Cette propriété est dépréciée et sera supprimée dans une version ultérieure.
type	Type d’outil. Toujours mcp pour les outils exposés par un serveur MCP.

Détails de la propriété

allowed_callers

Les appelants qui peuvent invoquer des outils exposés par ce serveur MCP.

allowed_callers?: CallableToolAllowedCaller[]

Valeur de propriété

CallableToolAllowedCaller[]

allowed_tools

Les noms d’outils ou le filtre qui déterminent quels outils du serveur MCP sont disponibles pour l’agent vocal.

allowed_tools?: string[] | MCPToolFilter

Valeur de propriété

string[] | MCPToolFilter

authorization

Un jeton d’accès OAuth pouvant être utilisé avec un serveur MCP distant, soit avec une URL MCP personnalisée ou un connecteur de service. Votre application doit gérer le flux d’autorisation OAuth et fournir le jeton ici.

authorization?: string

Valeur de propriété

string

defer_loading

Si cet outil MCP est différé et découvert via la recherche d’outils.

defer_loading?: boolean

Valeur de propriété

boolean

headers

Des en-têtes HTTP à inclure dans les requêtes vers le serveur MCP.

headers?: Record<string, string>

Valeur de propriété

Record<string, string>

project_connection_id

ID de connexion dans le project du serveur MCP. La connexion stocke l’authentification et d’autres détails de connexion nécessaires pour se connecter au serveur MCP.

project_connection_id?: string

Valeur de propriété

string

require_approval

La politique d’approbation pour les appels d’outils MCP, spécifiée globalement ou pour des outils sélectionnés.

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

Valeur de propriété

MCPToolRequireApproval | "always" | "never"

response_scheduling

Lorsque l’invocation MCP crée une réponse de suivi. La valeur par défaut est when_idle.

response_scheduling?: VoiceAgentToolResponseScheduling

Valeur de propriété

VoiceAgentToolResponseScheduling

server_description

Description facultative du serveur MCP, utilisée pour fournir davantage de contexte.

server_description?: string

Valeur de propriété

string

server_label

Étiquette de ce serveur MCP, utilisée pour l’identifier dans les appels d’outils.

server_label: string

Valeur de propriété

string

server_url

URL du serveur MCP. Un de server_url, connector_id, ou tunnel_id doit être fourni.

server_url?: string

Valeur de propriété

string

tool_configs

Deprecated. Cette propriété est dépréciée et sera supprimée dans une version ultérieure.

tool_configs?: Record<string, ToolConfig>

Valeur de propriété

Record<string, ToolConfig>

type

Type d’outil. Toujours mcp pour les outils exposés par un serveur MCP.

type: "mcp"

Valeur de propriété

"mcp"