Lista de ferramentas MCP e suporte a ambientes - AgentBay - AgentBay: Central de Documentação do Alibaba Cloud

Lista todas as ferramentas MCP disponíveis no AgentBay e os ambientes de sandbox compatíveis com cada uma.

Visão geral das ferramentas MCP do AgentBay

Matriz de suporte às ferramentas MCP

Capacidade	Nome da ferramenta	Descrição	BrowserUse	ComputerUse Linux	ComputerUse Windows	MobileUse	CodeSpace
Crie ambiente de sandbox	`create_sandbox`	Cria um novo ambiente de sandbox do AgentBay e retorna o ID da sandbox.	Compatível	Compatível	Compatível	Compatível	Não compatível
Obter URL de acesso à sandbox	`get_sandbox_url`	Obtém a URL de acesso em tempo de execução da sandbox. Cada URL expira após o uso.	Compatível	Compatível	Compatível	Compatível	Não compatível
Capturar screenshot de tela cheia e compartilhar	`system_screenshot`	Captura uma screenshot de tela cheia do display atual e retorna uma URL compartilhável.	Compatível	Compatível	Compatível	Compatível	Não compatível
Liberar recursos da sandbox	`kill_sandbox`	Libera os recursos da sandbox após a conclusão da tarefa.	Compatível	Compatível	Compatível	Compatível	Não compatível
Passar o mouse sobre elemento do navegador	`browser_hover`	Passa o cursor do mouse sobre um elemento da página.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Arrastar elemento do navegador	`browser_drag`	Executa uma operação de arrastar e soltar entre dois elementos.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Voltar no navegador	`browser_navigate_back`	Navega para a página anterior.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Obter requisições de rede	`browser_network_requests`	Retorna todas as requisições de rede feitas após o carregamento da página.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Fazer upload de arquivo no navegador	`browser_file_upload`	Faz upload de um ou mais arquivos.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Pressionar tecla no navegador	`browser_press_key`	Pressiona uma tecla no teclado.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Preenchimento de formulário em lote	`browser_fill_form`	Preenche vários campos de formulário simultaneamente.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Digitar texto no navegador	`browser_type`	Digita texto em um elemento editável.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Redimensionar janela do navegador	`browser_resize`	Redimensiona a janela do navegador.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Capturar snapshot da página	`browser_snapshot`	Captura um snapshot de acessibilidade da página atual; preferível a screenshots para executar ações.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Fechar página atual	`browser_close`	Fecha a página atual.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Gerencie abas do navegador	`browser_tabs`	Lista, cria, fecha ou alterna entre abas do navegador.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Obter mensagens do console	`browser_console_messages`	Retorna todas as mensagens do console.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Instale navegador	`browser_install`	Instala o navegador especificado na configuração.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Avaliar expressão JavaScript	`browser_evaluate`	Avalia uma expressão JavaScript na página ou em um elemento.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Acesse URL no navegador	`browser_navigate`	Navega para uma URL especificada.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Capturar screenshot da página	`browser_take_screenshot`	Tira uma screenshot da página atual.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Clique em no navegador	`browser_click`	Executa um clique em uma página web.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Lidar com caixa de diálogo pop-up	`browser_handle_dialog`	Gerencia caixas de diálogo pop-up.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Aguardar conteúdo da página	`browser_wait_for`	Aguarda o aparecimento ou desaparecimento de texto, ou espera por um tempo especificado.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Selecione opção em menu suspenso	`browser_select_option`	Seleciona uma opção em um menu suspenso.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Observar elementos de UI assincronamente	`page_use_observe_async`	Localiza e descreve assincronamente elementos de UI interativos em uma página.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Obter resultado da tarefa de extração	`page_use_get_extract_result`	Obtém o resultado de uma tarefa de extração assíncrona.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Crie tarefa de planejamento	`browser_use_create_planner_task`	Cria uma tarefa de planejamento que divide uma tarefa em etapas detalhadas.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
URL de navegação	`page_use_navigate`	Navega para uma URL especificada no navegador.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Obter progresso da tarefa de operação	`page_use_get_act_result`	Obtém o progresso atual ou o resultado final de uma tarefa de operação assíncrona.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Execute tarefa em linguagem natural	`browser_use_execute_task`	Executa uma tarefa descrita em linguagem natural.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Capturar screenshot da página web	`page_use_screenshot`	Captura uma imagem da página web atual.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Obter resultado da tarefa de observação	`page_use_get_observe_result`	Obtém o resultado de uma tarefa de observação assíncrona.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Consultar status da tarefa	`browser_use_get_task_status`	Consulta o status de uma tarefa pelo seu ID.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Extrair dados da página web	`page_use_extract`	Recupera informações ou dados de uma página web com base em instruções.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Execute operação de página sincronamente	`page_use_act`	Executa sincronamente uma ou mais operações na página web atual.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Execute operação de página assincronamente	`page_use_act_async`	Inicia uma ou mais operações assincronamente e retorna um ID de tarefa.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Encerrar tarefa em execução	`browser_use_terminate_task`	Encerra uma tarefa em execução pelo seu ID.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Extrair dados web assincronamente	`page_use_extract_async`	Recupera assincronamente informações ou dados de uma página web.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Fazer login na página	`page_use_login`	Executa uma operação de login usando configurações específicas.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Localizar elementos interativos	`page_use_observe`	Localiza e descreve elementos de UI interativos na página atual.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Fechar sessão do navegador	`page_use_close_session`	Fecha a sessão de proxy do navegador atual e limpa os recursos.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Screenshot da área de trabalho em formato Base64	`screenshot`	Captura uma screenshot da área de trabalho e retorna dados codificados em base64.	Compatível	Compatível	Compatível	Compatível	Não compatível
Parar navegador Chrome	`stopChrome`	Para o navegador Chrome.	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Iniciar Chrome com CDP	`startChromeByCdp`	Inicia o Chrome e cria uma porta de depuração WebSocket para o Chrome DevTools Protocol (CDP).	Compatível	Não compatível	Não compatível	Não compatível	Não compatível
Edite arquivo por linha	`edit_file`	Edita um arquivo de texto linha por linha. Mostra alterações no formato diff estilo git.	Compatível	Compatível	Compatível	Compatível	Não compatível
Obter metadados do arquivo	`get_file_info`	Obtém metadados detalhados de um arquivo ou diretório.	Compatível	Compatível	Compatível	Compatível	Não compatível
Monitorar alterações de arquivo	`get_file_change`	Monitora eventos do sistema de arquivos em um diretório e retorna novos eventos.	Compatível	Compatível	Compatível	Compatível	Não compatível
Ler conteúdo do arquivo	`read_file`	Lê o conteúdo do arquivo do sistema de arquivos. Suporta parâmetros de deslocamento e comprimento.	Compatível	Compatível	Compatível	Compatível	Não compatível
Ler múltiplos arquivos	`read_multiple_files`	Lê o conteúdo de vários arquivos simultaneamente.	Compatível	Compatível	Compatível	Compatível	Não compatível
Listar arquivos do diretório	`list_directory`	Obtém uma lista detalhada de todos os arquivos e diretórios em um caminho especificado.	Compatível	Compatível	Compatível	Compatível	Não compatível
Mover ou renomear arquivo	`move_file`	Move ou renomeia arquivos e diretórios.	Compatível	Compatível	Compatível	Compatível	Não compatível
Pesquisar arquivos recursivamente	`search_files`	Pesquisa recursivamente por arquivos e diretórios correspondentes a um padrão usando o comando find.	Compatível	Compatível	Compatível	Compatível	Não compatível
Escrever conteúdo no arquivo	`write_file`	Cria um novo arquivo ou escreve conteúdo em um arquivo existente.	Compatível	Compatível	Compatível	Compatível	Não compatível
Copiar arquivo ou diretório	`copy_file`	Copia um arquivo ou diretório para um novo local mantendo o original.	Compatível	Compatível	Compatível	Compatível	Não compatível
Exclua arquivo ou diretório	`delete_file`	Exclui arquivos e diretórios do sistema de arquivos.	Compatível	Compatível	Compatível	Compatível	Compatível
Crie diretório	`create_directory`	Cria um novo diretório ou garante que ele exista.	Compatível	Compatível	Compatível	Compatível	Não compatível
Execute comando shell	`shell`	Executa um comando shell ou cmd com tempo limite.	Compatível	Compatível	Compatível	Compatível	Não compatível
Obter métricas do sistema	`get_metrics`	Obtém métricas do sistema, incluindo estatísticas de CPU, memória, disco e rede.	Compatível	Compatível	Compatível	Compatível	Não compatível
Listar aplicativos instalados	`get_installed_apps`	Obtém uma lista de aplicativos instalados no sistema.	Não compatível	Compatível	Compatível	Compatível	Não compatível
Iniciar aplicativo	`start_app`	Inicia um aplicativo usando um comando especificado.	Não compatível	Compatível	Compatível	Compatível	Não compatível
Parar aplicativo por comando	`stop_app_by_cmd`	Para um aplicativo usando um comando de parada.	Não compatível	Compatível	Compatível	Compatível	Não compatível
Obter posição do cursor do mouse	`get_cursor_position`	Obtém a posição atual do cursor do mouse na tela.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Arrastar mouse	`drag_mouse`	Arrasta o mouse de um ponto inicial até um ponto final.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Obter tamanho da tela	`get_screen_size`	Obtém a largura, altura e taxa de escala DPI da tela principal.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Mover cursor do mouse	`move_mouse`	Move o cursor do mouse para uma coordenada de tela especificada.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Liberar teclas do teclado	`release_keys`	Libera múltiplas teclas do teclado.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Pressionar atalho de teclado	`press_keys`	Pressiona múltiplas teclas do teclado simultaneamente. Suporta atalhos.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Insira texto	`input_text`	Insere o texto especificado.	Não compatível	Compatível	Compatível	Compatível	Não compatível
Rolar roda do mouse	`scroll`	Rola a roda do mouse em uma coordenada especificada.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Clique em com o mouse	`click_mouse`	Clica em uma coordenada absoluta especificada.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Defina janela como tela cheia	`fullscreen_window`	Define uma janela especificada para o modo de tela cheia.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Minimizar janela	`minimize_window`	Minimiza uma janela especificada.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Redimensionar janela	`resize_window`	Redimensiona uma janela especificada.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Ative janela	`activate_window`	Ativa (foca) uma janela especificada.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Listar janelas raiz	`list_root_windows`	Lista todas as janelas raiz e suas informações associadas.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Maximizar janela	`maximize_window`	Maximiza uma janela especificada.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Fechar janela	`close_window`	Fecha uma janela especificada.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Obter informações da janela ativa	`get_active_window`	Obtém informações detalhadas sobre a janela ativa atual.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Controle do modo de foco	`focus_mode`	Ativa ou desativa o modo de foco para restringir o escopo da janela em primeiro plano.	Não compatível	Compatível	Não compatível	Não compatível	Não compatível
Restaurar janela ao estado normal	`restore_window`	Restaura uma janela especificada ao seu estado normal.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Parar processo por nome	`stop_app_by_pname`	Para todos os processos relacionados pelo nome do processo.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Listar aplicativos visíveis	`list_visible_apps`	Lista todos os aplicativos com janelas visíveis e suas informações de processo.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Parar processo por PID	`stop_app_by_pid`	Encerra um processo especificado pelo seu PID.	Não compatível	Compatível	Compatível	Não compatível	Não compatível
Execute código na sandbox	`run_code`	Executa um trecho de código especificado na sandbox. Suporta múltiplas linguagens de programação.	Não compatível	Compatível	Não compatível	Não compatível	Não compatível
Código para busca semântica	`search_codebase`	Pesquisa por código ou conhecimento na base de código por significado usando busca semântica.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Pesquisar símbolos de código	`search_symbol`	Descobre símbolos de código e seus relacionamentos (classes, métodos, interfaces, etc.).	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Listar estrutura de diretórios	`list_dir`	Lista o conteúdo do diretório para ajudar a entender a estrutura de arquivos.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Busca glob para caminhos de arquivo	`search_file`	Pesquisa caminhos de arquivo no workspace usando padrões glob.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Busca regex no código	`grep_code`	Executa busca de conteúdo de arquivo de alto desempenho usando o mecanismo ripgrep.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Obter erros de compilação	`get_problems`	Obtém erros de compilação ou lint em arquivos de código.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Execute comando no terminal	`run_in_terminal`	Executa um comando shell no terminal.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Obter saída do terminal	`get_terminal_output`	Obtém a saída de execução de comandos de terminal em segundo plano.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Visualizar serviço web	`run_preview`	Configura um navegador de visualização para um serviço web local.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Substituição exata de string	`search_replace`	Substitui strings exatas em um arquivo.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Crie ou sobrescrever arquivo	`create_file`	Cria um novo arquivo ou sobrescreve um arquivo existente com o conteúdo especificado.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Gerenciamento de lista de tarefas	`todo_write`	Cria e gerencia listas de tarefas para acompanhar tarefas complexas de múltiplas etapas.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Fazer pergunta ao usuário	`ask_user_question`	Faz perguntas ao usuário durante a execução para coletar preferências ou decisões.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Alternar modo de interação	`switch_mode`	Alterna entre modos de interação (por exemplo, alternar para o modo de planejamento).	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Crie plano de implementação	`create_plan`	Cria e armazena um plano de implementação conciso.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Atualize dados de memória	`update_memory`	Atualiza, adiciona ou exclui memória com base na intenção do usuário.	Não compatível	Não compatível	Não compatível	Não compatível	Compatível
Tocar no dispositivo móvel	`tap`	Executa uma ação de toque em uma coordenada de tela especificada (móvel).	Não compatível	Não compatível	Não compatível	Compatível	Não compatível
Deslizar na tela	`swipe`	Executa um gesto de deslizamento na tela.	Não compatível	Não compatível	Não compatível	Compatível	Não compatível
Enviar evento de tecla	`send_key`	Envia um evento de tecla com um código de tecla especificado (por exemplo, tecla Voltar ou HOME).	Não compatível	Não compatível	Não compatível	Compatível	Não compatível
Limpar texto do campo de entrada	`clear_text`	Limpa o texto no campo de entrada atual.	Não compatível	Não compatível	Não compatível	Compatível	Não compatível
Capturar screenshot longa com rolagem	`long_screenshot`	Tira uma screenshot longa rolando a tela e unindo as imagens.	Não compatível	Não compatível	Não compatível	Compatível	Não compatível
Obter todos os elementos de UI	`get_all_ui_elements`	Obtém todos os elementos de UI no dispositivo, incluindo os não interativos.	Não compatível	Não compatível	Não compatível	Compatível	Não compatível
Obter elementos de UI clicáveis	`get_clickable_ui_elements`	Obtém todos os elementos de UI clicáveis no dispositivo.	Não compatível	Não compatível	Não compatível	Compatível	Não compatível
Iniciar tarefa assíncrona	`execute_task`	Inicia uma tarefa móvel assíncrona e retorna um ID de tarefa.	Não compatível	Não compatível	Não compatível	Compatível	Não compatível
Consultar status da tarefa assíncrona	`get_task_status`	Obtém o status e o fluxo de saída incremental de uma tarefa assíncrona.	Não compatível	Não compatível	Não compatível	Compatível	Não compatível
Encerrar tarefa assíncrona	`terminate_task`	Encerra uma tarefa assíncrona em execução.	Não compatível	Não compatível	Não compatível	Compatível	Não compatível
Enviar códigos de varredura do teclado	`send_scan_codes`	Envia códigos de varredura brutos do teclado para controle de entrada de teclado de baixo nível.	Não compatível	Não compatível	Compatível	Não compatível	Não compatível

Detalhes das capacidades das ferramentas

Capacidade da ferramenta	Nome da ferramenta	Descrição da ferramenta	Exemplo de parâmetro
Crie ambiente de sandbox	`create_sandbox`	Cria uma nova sandbox do AgentBay e retorna seu ID.	`{ "type": "object", "properties": {}, "required": [] }`
Obter URL de acesso à sandbox	`get_sandbox_url`	Obtém a URL de runtime do Wuying MCP para acesso do usuário. Cada URL é válida para um único uso e expira imediatamente.	`{ "type": "object", "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." } }, "required": [ "sandbox_id" ] }`
Capturar screenshot de tela cheia e compartilhar	`system_screenshot`	Captura uma screenshot de tela cheia e retorna uma URL compartilhável. A screenshot é processada automaticamente e armazenada com segurança. Por questões de segurança, a URL expira após 64 minutos.	`{ "type": "object", "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." } }, "required": [ "sandbox_id" ] }`
Liberar recursos da sandbox	`kill_sandbox`	Libera recursos após a conclusão da tarefa.	`{ "type": "object", "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." } }, "required": [ "sandbox_id" ] }`
Execute comando shell	`shell`	Executa um comando shell e retorna a saída ou um erro.	`{ "inputSchema": { "properties": { "command": { "description": "The command entered by the client.", "type": "string" }, "timeout_ms": { "default": 1000, "description": "The command execution timeout in milliseconds. If not specified, a default value (for example, 1000 ms) is used.", "type": "integer" } }, "required": ["command", "timeout_ms"], "type": "object" } }`
Fechar página do navegador	`browser_close`	Fecha a página do navegador.	`{ "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Redimensionar janela do navegador	`browser_resize`	Redimensiona a janela do navegador.	`{ "inputSchema": { "type": "object", "properties": { "width": { "type": "number", "description": "The width of the browser window." }, "height": { "type": "number", "description": "The height of the browser window." } }, "required": ["width", "height"], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Obter mensagens do console	`browser_console_messages`	Retorna todas as mensagens do console.	`{ "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Lidar com caixa de diálogo pop-up	`browser_handle_dialog`	Gerencia uma caixa de diálogo.	`{ "inputSchema": { "type": "object", "properties": { "accept": { "type": "boolean", "description": "Whether to accept the dialog box." }, "promptText": { "type": "string", "description": "The prompt text in a prompt dialog box." } }, "required": ["accept"], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Fazer upload de arquivo no navegador	`browser_file_upload`	Faz upload de um ou mais arquivos.	`{ "inputSchema": { "type": "object", "properties": { "paths": { "type": "array", "items": { "type": "string" }, "description": "The absolute paths of the files to upload. Can be a single file or multiple files." } }, "required": ["paths"], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Instale navegador	`browser_install`	Instala o navegador especificado na configuração. Use esta opção se receber um erro de navegador não instalado.	`{ "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Pressionar tecla no navegador	`browser_press_key`	Pressiona uma tecla no teclado.	{ "inputSchema": { "type": "object", "properties": { "key": { "type": "string", "description": "The name of the key to press or the character to generate, such as `ArrowLeft` or `a`." } }, "required": ["key"], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }
Acesse URL no navegador	`browser_navigate`	Navega para uma URL.	`{ "inputSchema": { "type": "object", "properties": { "url": { "type": "string", "description": "The URL to navigate to." } }, "required": ["url"], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Voltar no navegador	`browser_navigate_back`	Navega para a página anterior.	`{ "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Avançar no navegador	`browser_navigate_forward`	Navega para a próxima página.	`{ "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Obter requisições de rede	`browser_network_requests`	Retorna todas as requisições de rede desde o carregamento da página.	`{ "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Capturar screenshot da página	`browser_take_screenshot`	Tira uma screenshot da página atual. Não é possível executar ações com base na screenshot. Use `browser_snapshot` para ações.	{ "inputSchema": { "type": "object", "properties": { "raw": { "type": "boolean", "description": "Whether to return uncompressed data in PNG format. The default is false, which returns a JPEG image." }, "filename": { "type": "string", "description": "The filename to save the screenshot. If not specified, the default is `page-{timestamp}.{png\|jpeg}`." }, "element": { "type": "string", "description": "A human-readable description of the element to get permission for the screenshot. If not provided, the viewport is captured. If `element` is provided, `ref` must also be provided." }, "ref": { "type": "string", "description": "A reference to the target element in the page snapshot. If not provided, the viewport is captured. If `ref` is provided, `element` must also be provided." } }, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }
Capturar snapshot da página	`browser_snapshot`	Captura um snapshot de acessibilidade da página atual.	`{ "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Clique em no navegador	`browser_click`	Executa um clique em uma página web.	`{ "inputSchema": { "type": "object", "properties": { "element": { "type": "string", "description": "A human-readable description of the element to get permission to interact with it." }, "ref": { "type": "string", "description": "A reference to the target element in the page snapshot." } }, "required": ["element", "ref"], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Arrastar elemento do navegador	`browser_drag`	Executa uma operação de arrastar e soltar entre dois elementos.	{ "inputSchema": { "type": "object", "properties": { "startElement": { "type": "string", "description": "A human-readable description of the source element to get permission to interact with it." }, "startRef": { "type": "string", "description": "A reference to the source element in the page snapshot." }, "endElement": { "type": "string", "description": "A human-readable description of the target element to get permission to interact with it." }, "endRef": { "type": "string", "description": "A reference to the target element in the page snapshot." } }, "required": ["startElement", "startRef", "endElement", "endRef"], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }
Passar o mouse sobre elemento do navegador	`browser_hover`	Passa o cursor do mouse sobre um elemento da página.	`{ "inputSchema": { "type": "object", "properties": { "element": { "type": "string", "description": "A human-readable description of the element to get permission to interact with it." }, "ref": { "type": "string", "description": "A reference to the target element in the page snapshot." } }, "required": ["element", "ref"], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Digitar texto no navegador	`browser_type`	Digita texto em um elemento editável.	{ "inputSchema": { "type": "object", "properties": { "element": { "type": "string", "description": "A human-readable description of the element to get permission to interact with it." }, "ref": { "type": "string", "description": "A reference to the target element in the page snapshot." }, "text": { "type": "string", "description": "The text to type into the element." }, "submit": { "type": "boolean", "description": "Whether to submit the entered text (press Enter after typing)." }, "slowly": { "type": "boolean", "description": "Whether to type character by character. This is useful for triggering key press handlers on the page. By default, the entire text is filled at once." } }, "required": ["element", "ref", "text"], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }
Selecione opção em menu suspenso	`browser_select_option`	Seleciona uma opção em um menu suspenso.	{ "inputSchema": { "type": "object", "properties": { "element": { "type": "string", "description": "A human-readable description of the element to get permission to interact with it." }, "ref": { "type": "string", "description": "A reference to the target element in the page snapshot." }, "values": { "type": "array", "items": { "type": "string" }, "description": "An array of values to select in the dropdown menu. Can be a single value or multiple values." } }, "required": ["element", "ref", "values"], "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }
Aguardar conteúdo da página	`browser_wait_for`	Aguarda o aparecimento ou desaparecimento de texto, ou a passagem de um tempo especificado.	`{ "inputSchema": { "type": "object", "properties": { "time": { "type": "number", "description": "The time to wait in seconds." }, "text": { "type": "string", "description": "The text to wait for." }, "textGone": { "type": "string", "description": "The text to wait for to disappear." } }, "additionalProperties": false, "$schema": "http://json-schema.org/draft-07/schema#" } }`
Crie diretório	`create_directory`	Cria um diretório, incluindo diretórios aninhados. Conclui silenciosamente se o diretório já existir. Funciona apenas em diretórios permitidos.	`{ "inputSchema": { "properties": { "path": { "description": "The path of the directory to create.", "type": "string" } }, "required": ["path"], "type": "object" } }`
Edite arquivo por linha	`edit_file`	Substitui sequências exatas de linhas em um arquivo de texto e retorna um diff no estilo git. Funciona apenas em diretórios permitidos.	{ "inputSchema": { "properties": { "dryRun": { "default": false, "description": "Preview changes using git-style diff format.", "type": "boolean" }, "edits": { "items": { "properties": { "newText": { "description": "The new text to replace with.", "type": "string" }, "oldText": { "description": "The text to search for - must be an exact match.", "type": "string" } }, "required": ["oldText", "newText"], "type": "object" }, "type": "array" }, "path": { "description": "The path of the file to edit.", "type": "string" } }, "required": ["path", "edits"], "type": "object" } }
Obter metadados do arquivo	`get_file_info`	Retorna metadados de arquivo ou diretório: tamanho, hora de criação, hora de modificação, permissões e tipo. Funciona apenas em diretórios permitidos.	`{ "inputSchema": { "properties": { "path": { "description": "The path of the file or directory to inspect.", "type": "string" } }, "required": ["path"], "type": "object" } }`
Ler conteúdo do arquivo	`read_file`	Lê o conteúdo do arquivo com parâmetros opcionais de deslocamento de bytes e comprimento. Se o comprimento for omitido ou 0, o arquivo é lido até o fim. Lida com várias codificações de texto e fornece mensagens de erro detalhadas se o arquivo não puder ser lido. Funciona apenas em diretórios permitidos.	`{ "inputSchema": { "properties": { "length": { "description": "The number of bytes to read. If omitted or 0, reads to the end of the file.", "minimum": 0, "type": "integer" }, "offset": { "default": 0, "description": "Start reading from this byte offset.", "minimum": 0, "type": "integer" }, "path": { "description": "The path of the file to read.", "type": "string" } }, "required": ["path"], "type": "object" } }`
Ler múltiplos arquivos	`read_multiple_files`	Lê vários arquivos simultaneamente. O conteúdo de cada arquivo é retornado com seu caminho como referência. Falhas individuais em arquivos não interrompem a operação geral. Funciona apenas em diretórios permitidos.	`{ "inputSchema": { "properties": { "paths": { "description": "An array of file paths to read.", "items": { "type": "string" }, "type": "array" } }, "required": ["paths"], "type": "object" } }`
Listar arquivos do diretório	`list_directory`	Lista todos os arquivos e diretórios em um caminho, prefixados com [FILE] ou [DIR]. Funciona apenas em diretórios permitidos.	`{ "inputSchema": { "properties": { "path": { "description": "The path of the directory to list.", "type": "string" } }, "required": ["path"], "type": "object" } }`
Mover ou renomear arquivo	`move_file`	Move ou renomeia arquivos e diretórios. Falha se o destino já existir. Tanto a origem quanto o destino devem estar em diretórios permitidos.	`{ "inputSchema": { "properties": { "destination": { "description": "The destination file or directory path.", "type": "string" }, "source": { "description": "The source file or directory path.", "type": "string" } }, "required": ["source", "destination"], "type": "object" } }`
Pesquisar arquivos recursivamente	`search_files`	Pesquisa recursivamente por arquivos e diretórios correspondentes a um padrão. Pesquisa em todos os subdiretórios a partir do caminho inicial. Diferencia maiúsculas de minúsculas e corresponde a nomes parciais. Retorna o caminho completo de todos os itens correspondentes. Pesquisa apenas em diretórios permitidos.	`{ "inputSchema": { "properties": { "excludePatterns": { "default": [], "description": "Patterns to exclude (optional).", "items": { "type": "string" }, "type": "array" }, "path": { "description": "The directory path to start the search from.", "type": "string" }, "pattern": { "description": "The pattern to match.", "type": "string" } }, "required": ["path", "pattern"], "type": "object" } }`
Escrever conteúdo no arquivo	`write_file`	Escreve conteúdo em um arquivo. Defina o parâmetro `mode` como `overwrite` (padrão) para substituir o conteúdo existente, ou `append` para adicionar ao final. Lida com conteúdo de texto com a codificação apropriada. Funciona apenas em diretórios permitidos.	`{ "inputSchema": { "properties": { "content": { "description": "The content to write.", "type": "string" }, "mode": { "default": "overwrite", "description": "Write mode: 'overwrite' clears the file, 'append' adds to the end of the file.", "enum": ["overwrite", "append"], "type": "string" }, "path": { "description": "The path of the file to write to.", "type": "string" } }, "required": ["path", "content"], "type": "object" } }`
Execute operação de página sincronamente	`page_use_act`	Executa uma ou mais ações na página web atual e bloqueia até que todas as ações sejam concluídas. Lida tanto com interações únicas quanto com sequências consecutivas de ações.	{ "type": "object", "title": "page_use_actArguments", "required": [ "sandbox_id", "action" ], "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." }, "dom_settle_timeout_ms": { "type": "integer", "title": "Dom Settle Timeout Ms" }, "page_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Page Id" }, "variables": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Variables" }, "action": { "type": "string", "title": "Action" }, "context_id": { "default": 0, "type": "integer", "title": "Context Id" }, "iframe": { "type": "boolean", "title": "Iframe" }, "timeout_ms": { "type": "integer", "title": "Timeout Ms" }, "use_vision": { "default": false, "type": "boolean", "title": "Use Vision" } } }
Capturar screenshot da página web	`page_use_screenshot`	Captura uma screenshot da página web atual. Suporta captura de página inteira, recorte de área e configurações de qualidade. Retorna uma URL de dados (`data:image`/`png;base64`).	{ "type": "object", "title": "page_use_screenshotArguments", "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." }, "page_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Page Id" }, "full_page": { "default": true, "type": "boolean", "title": "Full Page" }, "context_id": { "default": 0, "type": "integer", "title": "Context Id" }, "clip": { "additionalProperties": { "type": "number" }, "type": "object", "title": "Clip" }, "timeout": { "type": "integer", "title": "Timeout" }, "quality": { "default": 80, "type": "integer", "title": "Quality" } }, "required": [ "sandbox_id" ] }
Fechar sessão do navegador	`page_use_close_session`	Fecha a sessão de proxy do navegador atual. Encerra o processo do navegador gerenciado pelo proxy e libera os recursos relacionados.	`{ "type": "object", "title": "page_use_close_sessionArguments", "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." } }, "required": [ "sandbox_id" ] }`
Localizar elementos interativos	`page_use_observe`	Identifica elementos de UI interativos (botões, campos de entrada, etc.) para uso em ações subsequentes. Descobre e descreve elementos com os quais é possível interagir. Use a ferramenta `observe` para encontrar elementos acionáveis. Use a ferramenta `extract` para dados estruturados ou conteúdo de texto.	{ "type": "object", "title": "page_use_observeArguments", "required": [ "sandbox_id", "instruction" ], "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." }, "dom_settle_timeout_ms": { "type": "integer", "title": "Dom Settle Timeout Ms" }, "page_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Page Id" }, "instruction": { "type": "string", "title": "Instruction" }, "context_id": { "default": 0, "type": "integer", "title": "Context Id" }, "iframe": { "default": false, "type": "boolean", "title": "Iframe" }, "use_vision": { "default": false, "type": "boolean", "title": "Use Vision" } } }
Execute operação de página assincronamente	`page_use_act_async`	Inicia assincronamente a execução de uma ou mais ações na página web atual e retorna um `task_id` para consulta de progresso. Diferentemente de `page_use_act`, este método não bloqueia até que as ações sejam concluídas. Ele inicia a execução imediatamente, retorna um `task_id` exclusivo e permite que o cliente consulte o progresso intermediário e o resultado final usando `page_use_get_act_result`.	{ "type": "object", "title": "page_use_act_asyncArguments", "required": [ "sandbox_id", "action" ], "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." }, "dom_settle_timeout_ms": { "type": "integer", "title": "Dom Settle Timeout Ms" }, "page_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Page Id" }, "variables": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Variables" }, "action": { "type": "string", "title": "Action" }, "context_id": { "default": 0, "type": "integer", "title": "Context Id" }, "iframe": { "type": "boolean", "title": "Iframe" }, "timeout_ms": { "type": "integer", "title": "Timeout Ms" }, "use_vision": { "default": false, "type": "boolean", "title": "Use Vision" } } }
Obter progresso da tarefa de operação assíncrona	`page_use_get_act_result`	Obtém o progresso atual ou o resultado final de uma tarefa de operação assíncrona. Este método deve ser usado com o `task_id` obtido de uma chamada anterior a `page_use_act_async`. Ele retorna o status atual da tarefa e, se a execução estiver concluída (`is_done`), inclui o conteúdo do resultado correspondente.	`{ "type": "object", "title": "page_use_get_act_resultArguments", "required": [ "sandbox_id", "task_id" ], "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." }, "task_id": { "type": "string", "title": "Task Id" } } }`
Obter resultado da tarefa de extração assíncrona	`page_use_get_extract_result`	Função assíncrona para obter o resultado de uma tarefa de extração.	`{ "type": "object", "title": "page_use_get_extract_resultArguments", "required": [ "sandbox_id", "task_id" ], "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." }, "task_id": { "type": "string", "title": "Task Id" } } }`
Acesse URL na página	`page_use_navigate`	Navega para a URL especificada no navegador.	`{ "type": "object", "title": "page_use_navigateArguments", "required": [ "sandbox_id", "url" ], "properties": { "sandbox_id": { "type": "string", "title": "Sandbox Id", "description": "The sandbox ID is the identifier for the tool execution environment. This sandbox_id comes from the create_sandbox tool." }, "url": { "type": "string", "title": "Url" } } }`
Execute código	`run_code`	Executa código no contexto especificado na plataforma Linux e retorna a saída ou um erro.	{ "inputSchema": { "properties": { "code": { "description": "The code to run.", "type": "string" }, "language": { "description": "The programming language for code execution. Supported values: 'python', 'javascript'. If not specified, Python is used by default.", "type": "string" }, "timeout_s": { "default": 300, "description": "Command execution timeout in seconds. If not specified, the default is 300 seconds, with a maximum of 3600 seconds.", "type": "integer" } }, "required": ["code"], "type": "object" } }

Visão geral das ferramentas MCP do AgentBay

Matriz de suporte às ferramentas MCP

Detalhes das capacidades das ferramentas

Crie ambiente de sandbox

Obter URL de acesso à sandbox

Capturar screenshot de tela cheia e compartilhar

Liberar recursos da sandbox

Execute comando shell

Fechar página do navegador

Redimensionar janela do navegador

Obter mensagens do console

Lidar com caixa de diálogo pop-up

Fazer upload de arquivo no navegador

Instale navegador

Pressionar tecla no navegador

Acesse URL no navegador

Voltar no navegador

Avançar no navegador

Obter requisições de rede

Capturar screenshot da página

Capturar snapshot da página

Clique em no navegador

Arrastar elemento do navegador

Digitar texto no navegador

Selecione opção em menu suspenso

Aguardar conteúdo da página

Crie diretório

Edite arquivo por linha

Obter metadados do arquivo

Ler conteúdo do arquivo

Ler múltiplos arquivos

Listar arquivos do diretório

Mover ou renomear arquivo

Pesquisar arquivos recursivamente

Escrever conteúdo no arquivo

Execute operação de página sincronamente

Capturar screenshot da página web

Fechar sessão do navegador

Localizar elementos interativos

Execute operação de página assincronamente

Obter progresso da tarefa de operação assíncrona

Obter resultado da tarefa de extração assíncrona

Acesse URL na página

Execute código