VoiceAgentMcpTool interface

Pakket:

@azure/ai-projects

Een MCP-tool beschikbaar voor een stemagent. Server-endpoints gebruiken server_url; connector- en tunnelidentificaties worden niet ondersteund.

Uitbreiding

VoiceAgentTool

Eigenschappen

allowed_callers	De aanroepers die mogelijk tools oproepen die door deze MCP-server worden blootgesteld.
allowed_tools	De toolnamen of filters die bepalen welke tools van de MCP-server beschikbaar zijn voor de voice agent.
authorization	Een OAuth-toegangstoken dat gebruikt kan worden met een externe MCP-server, hetzij met een aangepaste MCP-server-URL of een serviceconnector. Je applicatie moet de OAuth-autorisatiestroom afhandelen en het token hier aanleveren.
defer_loading	Of deze MCP-tool wordt uitgesteld en ontdekt via toolzoek.
headers	HTTP-headers om op te nemen in verzoeken naar de MCP-server.
project_connection_id	De verbindings-id in de project voor de MCP-server. De verbinding slaat verificatie en andere verbindingsgegevens op die nodig zijn om verbinding te maken met de MCP-server.
require_approval	Het goedkeuringsbeleid voor MCP-tooloproepen, globaal of voor geselecteerde tools.
response_scheduling	Wanneer de MCP-aanroep een vervolgrespons creëert. Wordt standaard ingesteld op when_idle.
server_description	Optionele beschrijving van de MCP-server, die wordt gebruikt om meer context te bieden.
server_label	Een label voor deze MCP-server, dat wordt gebruikt om het te identificeren in hulpprogramma-aanroepen.
server_url	De URL voor de MCP-server. Eén van server_url, connector_id, of tunnel_id moet worden aangeleverd.
tool_configs	Deprecated. Deze eigenschap is verouderd en zal in een toekomstige versie worden verwijderd.
type	Het type hulpprogramma. Altijd mcp voor tools die door een MCP-server worden blootgesteld.

Eigenschapdetails

allowed_callers

De aanroepers die mogelijk tools oproepen die door deze MCP-server worden blootgesteld.

allowed_callers?: CallableToolAllowedCaller[]

Waarde van eigenschap

CallableToolAllowedCaller[]

allowed_tools

De toolnamen of filters die bepalen welke tools van de MCP-server beschikbaar zijn voor de voice agent.

allowed_tools?: string[] | MCPToolFilter

Waarde van eigenschap

string[] | MCPToolFilter

authorization

Een OAuth-toegangstoken dat gebruikt kan worden met een externe MCP-server, hetzij met een aangepaste MCP-server-URL of een serviceconnector. Je applicatie moet de OAuth-autorisatiestroom afhandelen en het token hier aanleveren.

authorization?: string

Waarde van eigenschap

string

defer_loading

Of deze MCP-tool wordt uitgesteld en ontdekt via toolzoek.

defer_loading?: boolean

Waarde van eigenschap

boolean

headers

HTTP-headers om op te nemen in verzoeken naar de MCP-server.

headers?: Record<string, string>

Waarde van eigenschap

Record<string, string>

project_connection_id

De verbindings-id in de project voor de MCP-server. De verbinding slaat verificatie en andere verbindingsgegevens op die nodig zijn om verbinding te maken met de MCP-server.

project_connection_id?: string

Waarde van eigenschap

string

require_approval

Het goedkeuringsbeleid voor MCP-tooloproepen, globaal of voor geselecteerde tools.

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

Waarde van eigenschap

MCPToolRequireApproval | "always" | "never"

response_scheduling

Wanneer de MCP-aanroep een vervolgrespons creëert. Wordt standaard ingesteld op when_idle.

response_scheduling?: VoiceAgentToolResponseScheduling

Waarde van eigenschap

VoiceAgentToolResponseScheduling

server_description

Optionele beschrijving van de MCP-server, die wordt gebruikt om meer context te bieden.

server_description?: string

Waarde van eigenschap

string

server_label

Een label voor deze MCP-server, dat wordt gebruikt om het te identificeren in hulpprogramma-aanroepen.

server_label: string

Waarde van eigenschap

string

server_url

De URL voor de MCP-server. Eén van server_url, connector_id, of tunnel_id moet worden aangeleverd.

server_url?: string

Waarde van eigenschap

string

tool_configs

Deprecated. Deze eigenschap is verouderd en zal in een toekomstige versie worden verwijderd.

tool_configs?: Record<string, ToolConfig>

Waarde van eigenschap

Record<string, ToolConfig>

type

Het type hulpprogramma. Altijd mcp voor tools die door een MCP-server worden blootgesteld.

type: "mcp"

Waarde van eigenschap

"mcp"