MCPTool interface

Pakiet:

@azure/ai-projects

Nadaj modelowi dostęp do dodatkowych narzędzi za pośrednictwem zdalnych serwerów protokołu MCP (Model Context Protocol). Dowiedz się więcej o mcp.

Rozszerzenie

Tool

Właściwości

allowed_tools	Lista dozwolonych nazw narzędzi dla serwera MCP.
authorization	Token dostępu OAuth, który może być używany z odległym serwerem MCP, zarówno z niestandardowym adresem URL serwera MCP, jak i przez złącze usług. Twoja aplikacja musi obsługiwać przepływ autoryzacji OAuth i udostępniać token tutaj.
connector_id	Identyfikator dla złączy usług, takich jak te dostępne w ChatGPT. Jeden z nich server_url lub connector_id musi być dostarczony. Dowiedz się więcej o złączach serwisowych tutaj. Obecnie wspierane connector_id wartości to: Dropbox: connector_dropbox Gmail: connector_gmail Kalendarz Google: connector_googlecalendar Google Drive: connector_googledrive Microsoft Teams: connector_microsoftteams Outlook Kalendarz: connector_outlookcalendar Outlook E-mail: connector_outlookemail SharePoint: connector_sharepoint
defer_loading	Czy to narzędzie MCP zostanie odroczone i odkryte przez wyszukiwanie narzędzi.
headers	Niestandardowe nagłówki do uwzględnienia w żądaniach do serwera MCP.
project_connection_id	Identyfikator połączenia w project dla serwera MCP. W połączeniu przechowywane są dane uwierzytelniające i inne szczegóły połączenia potrzebne do nawiązania połączenia z serwerem MCP.
require_approval	Wymagania dotyczące zatwierdzenia narzędzia MCP.
server_description	Opcjonalny opis serwera MCP, służący do uzyskania większego kontekstu.
server_label	Etykieta dla tego serwera MCP używana do identyfikowania go w wywołaniach narzędzi.
server_url	Adres URL serwera MCP. Jeden z nich server_url lub connector_id musi być dostarczony.
tool_configs	Mapa konfiguracji dla poszczególnych narzędzi. Klucze to nazwy narzędzi lub * (domyślnie catch-all). Kolejność rozdzielczości: dokładne dopasowanie nazw narzędzi ma pierwszeństwo przed *. Nieznane nazwy narzędzi są cicho ignorowane podczas działania.
type	Typ narzędzia MCP. Zawsze mcp.

Szczegóły właściwości

allowed_tools

Lista dozwolonych nazw narzędzi dla serwera MCP.

allowed_tools?: string[] | MCPToolFilter

Wartość właściwości

string[] | MCPToolFilter

authorization

Token dostępu OAuth, który może być używany z odległym serwerem MCP, zarówno z niestandardowym adresem URL serwera MCP, jak i przez złącze usług. Twoja aplikacja musi obsługiwać przepływ autoryzacji OAuth i udostępniać token tutaj.

authorization?: string

Wartość właściwości

string

connector_id

Identyfikator dla złączy usług, takich jak te dostępne w ChatGPT. Jeden z nich server_url lub connector_id musi być dostarczony. Dowiedz się więcej o złączach serwisowych tutaj. Obecnie wspierane connector_id wartości to:

• Dropbox: connector_dropbox
• Gmail: connector_gmail
• Kalendarz Google: connector_googlecalendar
• Google Drive: connector_googledrive
• Microsoft Teams: connector_microsoftteams
• Outlook Kalendarz: connector_outlookcalendar
• Outlook E-mail: connector_outlookemail
• SharePoint: connector_sharepoint

connector_id?: "connector_dropbox" | "connector_gmail" | "connector_googlecalendar" | "connector_googledrive" | "connector_microsoftteams" | "connector_outlookcalendar" | "connector_outlookemail" | "connector_sharepoint"

Wartość właściwości

"connector_dropbox" | "connector_gmail" | "connector_googlecalendar" | "connector_googledrive" | "connector_microsoftteams" | "connector_outlookcalendar" | "connector_outlookemail" | "connector_sharepoint"

defer_loading

Czy to narzędzie MCP zostanie odroczone i odkryte przez wyszukiwanie narzędzi.

defer_loading?: boolean

Wartość właściwości

boolean

headers

Niestandardowe nagłówki do uwzględnienia w żądaniach do serwera MCP.

headers?: Record<string, string>

Wartość właściwości

Record<string, string>

project_connection_id

Identyfikator połączenia w project dla serwera MCP. W połączeniu przechowywane są dane uwierzytelniające i inne szczegóły połączenia potrzebne do nawiązania połączenia z serwerem MCP.

project_connection_id?: string

Wartość właściwości

string

require_approval

Wymagania dotyczące zatwierdzenia narzędzia MCP.

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

Wartość właściwości

MCPToolRequireApproval | "always" | "never"

server_description

Opcjonalny opis serwera MCP, służący do uzyskania większego kontekstu.

server_description?: string

Wartość właściwości

string

server_label

Etykieta dla tego serwera MCP używana do identyfikowania go w wywołaniach narzędzi.

server_label: string

Wartość właściwości

string

server_url

Adres URL serwera MCP. Jeden z nich server_url lub connector_id musi być dostarczony.

server_url?: string

Wartość właściwości

string

tool_configs

Mapa konfiguracji dla poszczególnych narzędzi. Klucze to nazwy narzędzi lub * (domyślnie catch-all). Kolejność rozdzielczości: dokładne dopasowanie nazw narzędzi ma pierwszeństwo przed *. Nieznane nazwy narzędzi są cicho ignorowane podczas działania.

tool_configs?: Record<string, ToolConfig>

Wartość właściwości

Record<string, ToolConfig>

type

Typ narzędzia MCP. Zawsze mcp.

type: "mcp"

Wartość właściwości

"mcp"