MCPTool interface

Pacote:

@azure/ai-projects

Forneça ao modelo acesso a ferramentas adicionais por meio de servidores remotos do Protocolo de Contexto de Modelo (MCP). Learn mais sobre MCP.

Extends

Tool

Propriedades

allowed_tools	A lista de nomes de ferramentas permitidos para o servidor MCP.
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.
connector_id	Identificador para conectores de serviço, como os disponíveis no ChatGPT. Um dos server_url ou connector_id deve ser fornecido. Saiba mais sobre conectores de serviço aqui. Os valores atualmente suportados connector_id são: Dropbox: connector_dropbox Gmail: connector_gmail Google Calendário: connector_googlecalendar Google Drive: connector_googledrive Microsoft Teams: connector_microsoftteams Outlook Calendário: connector_outlookcalendar Outlook E-mail: connector_outlookemail SharePoint: connector_sharepoint
defer_loading	Se essa ferramenta MCP é adiada e descoberta por meio de busca de ferramentas.
headers	Cabeçalhos personalizados para incluir em 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	Os requisitos de aprovação para a ferramenta MCP.
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. Um dos server_url ou connector_id deve ser fornecido.
type	O tipo da ferramenta MCP. Sempre mcp.

Detalhes da propriedade

allowed_tools

A lista de nomes de ferramentas permitidos para o servidor MCP.

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

connector_id

Identificador para conectores de serviço, como os disponíveis no ChatGPT. Um dos server_url ou connector_id deve ser fornecido. Saiba mais sobre conectores de serviço aqui. Os valores atualmente suportados connector_id são:

• Dropbox: connector_dropbox
• Gmail: connector_gmail
• Google Calendário: connector_googlecalendar
• Google Drive: connector_googledrive
• Microsoft Teams: connector_microsoftteams
• Outlook Calendário: 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"

Valor da propriedade

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

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 personalizados para incluir em 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

Os requisitos de aprovação para a ferramenta MCP.

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

Valor da propriedade

MCPToolRequireApproval | "always" | "never"

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. Um dos server_url ou connector_id deve ser fornecido.

server_url?: string

Valor da propriedade

string

type

O tipo da ferramenta MCP. Sempre mcp.

type: "mcp"

Valor da propriedade

"mcp"