VoiceAgentMcpTool interface

Paquete:
@azure/ai-projects

Una herramienta MCP disponible para un agente de voz. Los extremos de servidor utilizan server_urlidentificadores de conector y túnel ; no se soportan identificadores de conectores y túneles.

Extends
VoiceAgentTool

Propiedades

allowed_callers

Los llamantes que pueden invocar herramientas expuestas por este servidor MCP.
allowed_tools

Los nombres de las herramientas o el filtro que determinan qué herramientas del servidor MCP están disponibles para el agente de voz.
authorization

Un token de acceso OAuth que puede usarse con un servidor MCP remoto, ya sea con una URL personalizada de servidor MCP o un conector de servicio. Tu aplicación debe gestionar el flujo de autorización OAuth y proporcionar el token aquí.
defer_loading

Si esta herramienta MCP se aplaza y se descubre mediante búsqueda de herramientas.
headers

Encabezados HTTP para incluir en las solicitudes al servidor MCP.
project_connection_id

Identificador de conexión del project para el servidor MCP. La conexión almacena la autenticación y otros detalles de conexión necesarios para conectarse al servidor MCP.
require_approval

La política de aprobación para llamadas a herramientas MCP, especificada globalmente o para herramientas seleccionadas.
response_scheduling

Cuando la invocación MCP crea una respuesta de seguimiento. Tiene como valor predeterminado when_idle.
server_description

Descripción opcional del servidor MCP, que se usa para proporcionar más contexto.
server_label

Etiqueta para este servidor MCP, que se usa para identificarlo en las llamadas a herramientas.
server_url

Dirección URL del servidor MCP. Uno de server_url, connector_id, o tunnel_id debe ser proporcionado.
tool_configs

Deprecated. Esta propiedad queda obsoleta y será eliminada en una versión futura.
type

Tipo de herramienta. Siempre mcp para herramientas expuestas por un servidor MCP.

Detalles de las propiedades

allowed_callers

Los llamantes que pueden invocar herramientas expuestas por este servidor MCP.

allowed_callers?: CallableToolAllowedCaller[]

Valor de propiedad

CallableToolAllowedCaller[]

allowed_tools

Los nombres de las herramientas o el filtro que determinan qué herramientas del servidor MCP están disponibles para el agente de voz.

allowed_tools?: string[] | MCPToolFilter

Valor de propiedad

string[] | MCPToolFilter

authorization

Un token de acceso OAuth que puede usarse con un servidor MCP remoto, ya sea con una URL personalizada de servidor MCP o un conector de servicio. Tu aplicación debe gestionar el flujo de autorización OAuth y proporcionar el token aquí.

authorization?: string

Valor de propiedad

string

defer_loading

Si esta herramienta MCP se aplaza y se descubre mediante búsqueda de herramientas.

defer_loading?: boolean

Valor de propiedad

boolean

headers

Encabezados HTTP para incluir en las solicitudes al servidor MCP.

headers?: Record<string, string>

Valor de propiedad

Record<string, string>

project_connection_id

Identificador de conexión del project para el servidor MCP. La conexión almacena la autenticación y otros detalles de conexión necesarios para conectarse al servidor MCP.

project_connection_id?: string

Valor de propiedad

string

require_approval

La política de aprobación para llamadas a herramientas MCP, especificada globalmente o para herramientas seleccionadas.

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

Valor de propiedad

MCPToolRequireApproval | "always" | "never"

response_scheduling

Cuando la invocación MCP crea una respuesta de seguimiento. Tiene como valor predeterminado when_idle.

response_scheduling?: VoiceAgentToolResponseScheduling

Valor de propiedad

VoiceAgentToolResponseScheduling

server_description

Descripción opcional del servidor MCP, que se usa para proporcionar más contexto.

server_description?: string

Valor de propiedad

string

server_label

Etiqueta para este servidor MCP, que se usa para identificarlo en las llamadas a herramientas.

server_label: string

Valor de propiedad

string

server_url

Dirección URL del servidor MCP. Uno de server_url, connector_id, o tunnel_id debe ser proporcionado.

server_url?: string

Valor de propiedad

string

tool_configs

Deprecated. Esta propiedad queda obsoleta y será eliminada en una versión futura.

tool_configs?: Record<string, ToolConfig>

Valor de propiedad

Record<string, ToolConfig>

type

Tipo de herramienta. Siempre mcp para herramientas expuestas por un servidor MCP.

type: "mcp"

Valor de propiedad

"mcp"