MCPToolboxTool interface

Package:

@azure/ai-projects

Un outil MCP stocké dans une boîte à outils.

Extends

ToolboxTool

Propriétés

allowed_callers	Les appelants qui peuvent invoquer cet outil MCP, soit directement, soit programmatiquement.
allowed_tools	Les outils MCP disponibles sont spécifiés par leur nom ou un filtre d’outil.
authorization	Un jeton d’accès OAuth pouvant être utilisé avec un serveur MCP distant, soit avec une URL MCP personnalisée ou un connecteur de service. Votre application doit gérer le flux d’autorisation OAuth et fournir le jeton ici.
connector_id	Identificateur des connecteurs de service, comme ceux disponibles dans ChatGPT. Un de server_url, connector_id, ou tunnel_id doit être fourni. En savoir plus sur les connecteurs de service ici. Les valeurs actuellement prises en charge connector_id sont les suivantes : Dropbox : connector_dropbox Gmail : connector_gmail Google Agenda : connector_googlecalendar Google Drive : connector_googledrive Microsoft Teams : connector_microsoftteams Outlook Calendrier : connector_outlookcalendar Outlook Email : connector_outlookemail SharePoint : connector_sharepoint
defer_loading	Si cet outil MCP est différé et découvert via la recherche d’outils.
headers	Des en-têtes HTTP personnalisés à inclure dans les requêtes vers le serveur MCP.
project_connection_id	ID de connexion dans le project du serveur MCP. La connexion stocke l’authentification et d’autres détails de connexion nécessaires pour se connecter au serveur MCP.
require_approval	Que les appels d’outils MCP nécessitent une approbation, soit pour tous les outils, soit pour les outils sélectionnés par filtres.
server_description	Description facultative du serveur MCP, utilisée pour fournir davantage de contexte.
server_label	Étiquette de ce serveur MCP, utilisée pour l’identifier dans les appels d’outils.
server_url	URL du serveur MCP. Un de server_url, connector_id, ou tunnel_id doit être fourni.
tunnel_id	L’identifiant sécurisé du tunnel MCP à utiliser au lieu d’une URL serveur directe. Un de server_url, connector_id, ou tunnel_id doit être fourni.
type	Le type d’outil boîte à outils MCP. A toujours la valeur mcp.

Propriétés héritées

description	Description optionnelle définie par l’utilisateur pour cet outil ou configuration.
name	Nom optionnel défini par l’utilisateur pour cet outil ou configuration.
tool_configs	Carte de configuration par outil. Les clés sont des noms d’outils ou * (par défaut fourre-tout). Ordre de résolution : la correspondance exacte du nom de l’outil a la priorité sur *. Les noms d’outils inconnus sont silencieusement ignorés à l’exécution.

Détails de la propriété

allowed_callers

Les appelants qui peuvent invoquer cet outil MCP, soit directement, soit programmatiquement.

allowed_callers?: CallableToolAllowedCaller[]

Valeur de propriété

CallableToolAllowedCaller[]

allowed_tools

Les outils MCP disponibles sont spécifiés par leur nom ou un filtre d’outil.

allowed_tools?: string[] | MCPToolFilter

Valeur de propriété

string[] | MCPToolFilter

authorization

Un jeton d’accès OAuth pouvant être utilisé avec un serveur MCP distant, soit avec une URL MCP personnalisée ou un connecteur de service. Votre application doit gérer le flux d’autorisation OAuth et fournir le jeton ici.

authorization?: string

Valeur de propriété

string

connector_id

Identificateur des connecteurs de service, comme ceux disponibles dans ChatGPT. Un de server_url, connector_id, ou tunnel_id doit être fourni. En savoir plus sur les connecteurs de service ici. Les valeurs actuellement prises en charge connector_id sont les suivantes :

• Dropbox : connector_dropbox
• Gmail : connector_gmail
• Google Agenda : connector_googlecalendar
• Google Drive : connector_googledrive
• Microsoft Teams : connector_microsoftteams
• Outlook Calendrier : connector_outlookcalendar
• Outlook Email : connector_outlookemail
• SharePoint : connector_sharepoint

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

Valeur de propriété

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

defer_loading

Si cet outil MCP est différé et découvert via la recherche d’outils.

defer_loading?: boolean

Valeur de propriété

boolean

headers

Des en-têtes HTTP personnalisés à inclure dans les requêtes vers le serveur MCP.

headers?: Record<string, string>

Valeur de propriété

Record<string, string>

project_connection_id

ID de connexion dans le project du serveur MCP. La connexion stocke l’authentification et d’autres détails de connexion nécessaires pour se connecter au serveur MCP.

project_connection_id?: string

Valeur de propriété

string

require_approval

Que les appels d’outils MCP nécessitent une approbation, soit pour tous les outils, soit pour les outils sélectionnés par filtres.

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

Valeur de propriété

MCPToolRequireApproval | "always" | "never"

server_description

Description facultative du serveur MCP, utilisée pour fournir davantage de contexte.

server_description?: string

Valeur de propriété

string

server_label

Étiquette de ce serveur MCP, utilisée pour l’identifier dans les appels d’outils.

server_label: string

Valeur de propriété

string

server_url

URL du serveur MCP. Un de server_url, connector_id, ou tunnel_id doit être fourni.

server_url?: string

Valeur de propriété

string

tunnel_id

L’identifiant sécurisé du tunnel MCP à utiliser au lieu d’une URL serveur directe. Un de server_url, connector_id, ou tunnel_id doit être fourni.

tunnel_id?: string

Valeur de propriété

string

type

Le type d’outil boîte à outils MCP. A toujours la valeur mcp.

type: "mcp"

Valeur de propriété

"mcp"

Détails de la propriété héritée

description

Description optionnelle définie par l’utilisateur pour cet outil ou configuration.

description?: string

Valeur de propriété

string

Hérité deToolboxTool.description

name

Nom optionnel défini par l’utilisateur pour cet outil ou configuration.

name?: string

Valeur de propriété

string

Héritée deToolboxTool.name

tool_configs

Carte de configuration par outil. Les clés sont des noms d’outils ou * (par défaut fourre-tout). Ordre de résolution : la correspondance exacte du nom de l’outil a la priorité sur *. Les noms d’outils inconnus sont silencieusement ignorés à l’exécution.

tool_configs?: Record<string, ToolConfig>

Valeur de propriété

Record<string, ToolConfig>

Héritée deToolboxTool.tool_configs