VoiceAgentMcpTool interface

Pacote:
@azure/ai-projects

Uma ferramenta MCP disponível para um agente de voz.

Extends
VoiceAgentTool

Propriedades

allowed_callers

Os chamadores que podem invocar ferramentas expostas por este servidor MCP.
allowed_tools

Os nomes das ferramentas ou filtro que determinam quais ferramentas do servidor MCP estão disponíveis para o agente de voz.
authorization

Um token de acesso OAuth que pode ser usado com um servidor MCP remoto, seja com uma URL personalizada de servidor MCP ou um conector de serviço. Sua aplicação deve lidar com o fluxo de autorização do OAuth e fornecer o token aqui.
defer_loading

Se essa ferramenta MCP é adiada e descoberta por meio de busca de ferramentas.
headers

Cabeçalhos HTTP para incluir nas requisições ao servidor MCP.
project_connection_id

A ID da conexão no project para o servidor MCP. A conexão armazena a autenticação e outros detalhes de conexão necessários para se conectar ao servidor MCP.
require_approval

A política de aprovação para chamadas de ferramentas MCP, especificada globalmente ou para ferramentas selecionadas.
response_scheduling

Quando a invocação MCP cria uma resposta de acompanhamento. Usa when_idle como padrão.
server_description

Descrição opcional do servidor MCP, usada para fornecer mais contexto.
server_label

Um rótulo para esse servidor MCP, usado para identificá-lo em chamadas de ferramenta.
server_url

A URL do servidor MCP.
tool_configs

Preterido. Esta propriedade está obsoleta e será removida em uma versão futura.
type

O tipo de ferramenta. Sempre mcp para ferramentas expostas por um servidor MCP.

Detalhes da propriedade

allowed_callers

Os chamadores que podem invocar ferramentas expostas por este servidor MCP.

allowed_callers?: CallableToolAllowedCaller[]

Valor da propriedade

CallableToolAllowedCaller[]

allowed_tools

Os nomes das ferramentas ou filtro que determinam quais ferramentas do servidor MCP estão disponíveis para o agente de voz.

allowed_tools?: string[] | MCPToolFilter

Valor da propriedade

string[] | MCPToolFilter

authorization

Um token de acesso OAuth que pode ser usado com um servidor MCP remoto, seja com uma URL personalizada de servidor MCP ou um conector de serviço. Sua aplicação deve lidar com o fluxo de autorização do OAuth e fornecer o token aqui.

authorization?: string

Valor da propriedade

string

defer_loading

Se essa ferramenta MCP é adiada e descoberta por meio de busca de ferramentas.

defer_loading?: boolean

Valor da propriedade

boolean

headers

Cabeçalhos HTTP para incluir nas requisições ao servidor MCP.

headers?: Record<string, string>

Valor da propriedade

Record<string, string>

project_connection_id

A ID da conexão no project para o servidor MCP. A conexão armazena a autenticação e outros detalhes de conexão necessários para se conectar ao servidor MCP.

project_connection_id?: string

Valor da propriedade

string

require_approval

A política de aprovação para chamadas de ferramentas MCP, especificada globalmente ou para ferramentas selecionadas.

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

Valor da propriedade

MCPToolRequireApproval | "always" | "never"

response_scheduling

Quando a invocação MCP cria uma resposta de acompanhamento. Usa when_idle como padrão.

response_scheduling?: VoiceAgentToolResponseScheduling

Valor da propriedade

VoiceAgentToolResponseScheduling

server_description

Descrição opcional do servidor MCP, usada para fornecer mais contexto.

server_description?: string

Valor da propriedade

string

server_label

Um rótulo para esse servidor MCP, usado para identificá-lo em chamadas de ferramenta.

server_label: string

Valor da propriedade

string

server_url

A URL do servidor MCP.

server_url?: string

Valor da propriedade

string

tool_configs

Preterido. Esta propriedade está obsoleta e será removida em uma versão futura.

tool_configs?: Record<string, ToolConfig>

Valor da propriedade

Record<string, ToolConfig>

type

O tipo de ferramenta. Sempre mcp para ferramentas expostas por um servidor MCP.

type: "mcp"

Valor da propriedade

"mcp"