MCPToolboxTool interface

パッケージ:

@azure/ai-projects

ツールボックスに収納されたMCPツールです。

Extends

ToolboxTool

プロパティ

allowed_callers	このMCPツールボックスツールを直接またはプログラム的に呼び出す可能性のある呼び出し者。
allowed_tools	使用可能なMCPツールは、名前またはツールフィルターで指定されています。
authorization	リモートMCPサーバーで使用できるOAuthアクセストークンで、カスタムMCPサーバーURLまたはサービスコネクターを使用します。 アプリケーションはOAuth認証フローを処理し、ここでトークンを提供しなければなりません。
connector_id	サービス コネクタの識別子 (ChatGPT で使用できるコネクタなど)。 server_url、connector_id、またはtunnel_idのいずれかが提供されなければなりません。 サービスコネクターについては こちらをご覧ください。 現在サポートされている connector_id 値は次のとおりです。 Dropbox： connector_dropbox Gmail: connector_gmail Googleカレンダー: connector_googlecalendar Google ドライブ: connector_googledrive Microsoft Teams:connector_microsoftteams Outlook カレンダー:connector_outlookcalendar Outlook メール:connector_outlookemail SharePoint:connector_sharepoint
defer_loading	このMCPツールが先送りされ、ツール検索によって発見されるかどうか。
headers	MCPサーバーへのリクエストに含めるカスタムHTTPヘッダー。
project_connection_id	MCP サーバーのproject内の接続 ID。 この接続には、MCP サーバーへの接続に必要な認証およびその他の接続の詳細が格納されます。
require_approval	MCPツール呼び出しがすべてのツールに対して承認が必要かどうか、またはフィルターで選択されたツールに対して承認が必要かどうか。
server_description	より多くのコンテキストを提供するために使用される MCP サーバーの省略可能な説明。
server_label	この MCP サーバーのラベル。ツール呼び出しで識別するために使用されます。
server_url	MCP サーバーの URL。 server_url、connector_id、またはtunnel_idのいずれかが提供されなければなりません。
tunnel_id	直接サーバーURLの代わりにSecure MCPトンネルIDを使うこと。 server_url、connector_id、またはtunnel_idのいずれかが提供されなければなりません。
type	MCPツールボックスツールの種類。 常に mcp です。

継承されたプロパティ

description	このツールや設定のオプションでユーザー定義の説明があります。
name	このツールまたは設定にはオプションでユーザー定義の名称を付けることができます。
tool_configs	ツールごとの設定マップ。 キーは工具名または * (万能のデフォルト)です。 解決順:正確なツール名の一致が *より優先されます。 未知のツール名は実行時に静かに無視されます。

プロパティの詳細

allowed_callers

このMCPツールボックスツールを直接またはプログラム的に呼び出す可能性のある呼び出し者。

allowed_callers?: CallableToolAllowedCaller[]

プロパティ値

CallableToolAllowedCaller[]

allowed_tools

使用可能なMCPツールは、名前またはツールフィルターで指定されています。

allowed_tools?: string[] | MCPToolFilter

プロパティ値

string[] | MCPToolFilter

authorization

リモートMCPサーバーで使用できるOAuthアクセストークンで、カスタムMCPサーバーURLまたはサービスコネクターを使用します。 アプリケーションはOAuth認証フローを処理し、ここでトークンを提供しなければなりません。

authorization?: string

プロパティ値

string

connector_id

サービス コネクタの識別子 (ChatGPT で使用できるコネクタなど)。 server_url、connector_id、またはtunnel_idのいずれかが提供されなければなりません。 サービスコネクターについては こちらをご覧ください。 現在サポートされている connector_id 値は次のとおりです。

• Dropbox： connector_dropbox
• Gmail: connector_gmail
• Googleカレンダー: connector_googlecalendar
• Google ドライブ: connector_googledrive
• Microsoft Teams:connector_microsoftteams
• Outlook カレンダー:connector_outlookcalendar
• Outlook メール:connector_outlookemail
• SharePoint:connector_sharepoint

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

プロパティ値

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

defer_loading

このMCPツールが先送りされ、ツール検索によって発見されるかどうか。

defer_loading?: boolean

プロパティ値

boolean

headers

MCPサーバーへのリクエストに含めるカスタムHTTPヘッダー。

headers?: Record<string, string>

プロパティ値

Record<string, string>

project_connection_id

MCP サーバーのproject内の接続 ID。 この接続には、MCP サーバーへの接続に必要な認証およびその他の接続の詳細が格納されます。

project_connection_id?: string

プロパティ値

string

require_approval

MCPツール呼び出しがすべてのツールに対して承認が必要かどうか、またはフィルターで選択されたツールに対して承認が必要かどうか。

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

プロパティ値

MCPToolRequireApproval | "always" | "never"

server_description

より多くのコンテキストを提供するために使用される MCP サーバーの省略可能な説明。

server_description?: string

プロパティ値

string

server_label

この MCP サーバーのラベル。ツール呼び出しで識別するために使用されます。

server_label: string

プロパティ値

string

server_url

MCP サーバーの URL。 server_url、connector_id、またはtunnel_idのいずれかが提供されなければなりません。

server_url?: string

プロパティ値

string

tunnel_id

直接サーバーURLの代わりにSecure MCPトンネルIDを使うこと。 server_url、connector_id、またはtunnel_idのいずれかが提供されなければなりません。

tunnel_id?: string

プロパティ値

string

type

MCPツールボックスツールの種類。 常に mcp です。

type: "mcp"

プロパティ値

"mcp"

継承されたプロパティの詳細

description

このツールや設定のオプションでユーザー定義の説明があります。

description?: string

プロパティ値

string

ToolboxTool.descriptionから引き継がれました

name

このツールまたは設定にはオプションでユーザー定義の名称を付けることができます。

name?: string

プロパティ値

string

ToolboxTool.nameから受け継いだ

tool_configs

ツールごとの設定マップ。 キーは工具名または * (万能のデフォルト)です。 解決順:正確なツール名の一致が *より優先されます。 未知のツール名は実行時に静かに無視されます。

tool_configs?: Record<string, ToolConfig>

プロパティ値

Record<string, ToolConfig>

ToolboxTool.tool_configsから受け継いだ