8. Capacidades do agente (tools)

O agente tem ferramentas para interagir com o teu projecto. Algumas são automáticas (read-only); outras pedem permissão antes de correr.

Ficheiros

read_file(path) — lê conteúdo (auto-aprovada para ficheiros não-sensíveis)
write_file(path, content) — escreve novo ficheiro / sobrescreve (mostra diff)
edit_file(path, edits) — edita ranges específicos num ficheiro (mostra diff)
create_file(path, content) — cria ficheiro novo (mostra diff)
delete_file(path) — apaga ficheiro (pede permissão)
rename_file(old, new) — renomeia (pede permissão)
list_directory(path) — lista pasta
glob(pattern) — encontra ficheiros por padrão
search_files(query) — pesquisa de conteúdo em ficheiros (ripgrep)

Execução

execute_command(command, cwd?) — corre comando shell (pede permissão; comandos perigosos têm prompt extra)
start_dev_server(command, projectKind) — arranca o dev server
read_dev_server_logs(since?) — lê logs do dev server (output + erros runtime do browser)

Código

get_diagnostics(path) — erros TypeScript no ficheiro
format_code(path) — Prettier
update_tasks(tasks) — atualiza a lista de tarefas visível

Skills

read_skill(name) — carrega skill completo
read_large_result(id) — lê resultado grande de uma chamada anterior

Sub-agentes (background research)

research(question, maxTurns) — sub-agente que investiga em paralelo (web + codebase)
verify(assertion, maxTurns) — sub-agente que verifica uma hipótese
spawn_background_agent(question) — sub-agente assíncrono (continua a correr enquanto trabalhas)
check_background_agents() — vê o estado dos sub-agentes activos

Browser (paid, on-demand via `/te2e`)

mcp__browser__browser_navigate — abre URL
mcp__browser__browser_snapshot — lê o estado da página (auto-aprovada, read-only)
mcp__browser__browser_click, browser_type, browser_press_key — interage (pede permissão)
mcp__browser__browser_console_messages — lê console errors
mcp__browser__browser_network_requests — lê network log

Ficheiros bloqueados

.env, .env.*, e ficheiros com nomes sensíveis (credentials, secrets) são sempre bloqueados — o agente nunca os lê nem escreve, mesmo que peças. Em vez disso, sugere criar .env.example com placeholders.

← Toda a documentação · versão markdown