Ferramentas de Código do Qwen

O Qwen Code inclui ferramentas integradas que o modelo utiliza para interagir com seu ambiente local, acessar informações e executar ações. Essas ferramentas ampliam as capacidades do CLI, permitindo que ele vá além da geração de texto e auxilie em uma ampla variedade de tarefas.

Visão geral das ferramentas do Qwen Code

No contexto do Qwen Code, as ferramentas são funções ou módulos específicos que o modelo pode solicitar para serem executados. Por exemplo, se você pedir ao modelo para “Resumir o conteúdo de my_document.txt”, ele provavelmente identificará a necessidade de ler esse arquivo e solicitará a execução da ferramenta read_file.

O componente principal (packages/core) gerencia essas ferramentas, apresenta suas definições (schemas) ao modelo, as executa quando solicitado e retorna os resultados ao modelo para processamento adicional em uma resposta voltada ao usuário.

Essas ferramentas fornecem os seguintes recursos:

Acesso a informações locais: As ferramentas permitem que o modelo acesse seu sistema de arquivos local, leia conteúdos de arquivos, liste diretórios, etc.
Execução de comandos: Com ferramentas como run_shell_command, o modelo pode executar comandos shell (com medidas de segurança apropriadas e confirmação do usuário).
Interação com a web: As ferramentas podem buscar conteúdo de URLs.
Execução de ações: As ferramentas podem modificar arquivos, escrever novos arquivos ou realizar outras ações no seu sistema (novamente, normalmente com proteções).
Respostas embasadas: Ao usar ferramentas para buscar dados em tempo real ou específicos do ambiente local, as respostas podem ser mais precisas, relevantes e embasadas no seu contexto real.

Como usar as ferramentas de código do Qwen

Para usar as ferramentas de código do Qwen, forneça um prompt para o CLI. O processo funciona da seguinte forma:

Você fornece um prompt para o CLI.
O CLI envia o prompt para o core.
O core, juntamente com seu prompt e o histórico da conversa, envia uma lista das ferramentas disponíveis e suas descrições/esquemas para a API do modelo configurado.
O modelo analisa sua solicitação. Se determinar que uma ferramenta é necessária, sua resposta incluirá uma requisição para executar uma ferramenta específica com determinados parâmetros.
O core recebe essa requisição de ferramenta, a valida e (geralmente após confirmação do usuário para operações sensíveis) executa a ferramenta.
A saída da ferramenta é enviada de volta ao modelo.
O modelo usa a saída da ferramenta para formular sua resposta final, que é então enviada de volta através do core para o CLI e exibida para você.

Você normalmente verá mensagens no CLI indicando quando uma ferramenta está sendo chamada e se ela teve sucesso ou falhou.

Segurança e confirmação

Muitas ferramentas, especialmente aquelas que podem modificar seu sistema de arquivos ou executar comandos (write_file, edit, run_shell_command), são projetadas com a segurança em mente. O Qwen Code normalmente irá:

Exigir confirmação: Solicitar sua confirmação antes de executar operações potencialmente sensíveis, mostrando a ação que está prestes a ser realizada.
Utilizar sandboxing: Todas as ferramentas estão sujeitas a restrições impostas pelo sandboxing (veja Sandboxing no Qwen Code). Isso significa que, ao operar em um sandbox, qualquer ferramenta (incluindo servidores MCP) que você deseje usar deve estar disponível dentro do ambiente do sandbox. Por exemplo, para executar um servidor MCP através do npx, o executável npx deve estar instalado na imagem Docker do sandbox ou estar disponível no ambiente sandbox-exec.

É importante sempre revisar atentamente os prompts de confirmação antes de permitir que uma ferramenta prossiga.

Saiba mais sobre as ferramentas do Qwen Code

As ferramentas integradas do Qwen Code podem ser categorizadas da seguinte forma:

Ferramentas do Sistema de Arquivos: Para interagir com arquivos e diretórios (leitura, escrita, listagem, busca, etc.).
Ferramenta Shell (run_shell_command): Para executar comandos shell.
Ferramenta Web Fetch (web_fetch): Para recuperar conteúdo de URLs.
Ferramenta Web Search (web_search): Para pesquisar na web.
Ferramenta Multi-File Read (read_many_files): Uma ferramenta especializada para ler conteúdo de vários arquivos ou diretórios, frequentemente usada pelo comando @.
Ferramenta de Memória (save_memory): Para salvar e recuperar informações entre sessões.
Ferramenta Todo Write (todo_write): Para criar e gerenciar listas de tarefas estruturadas durante as sessões de codificação.

Além disso, essas ferramentas incorporam:

Servidores MCP: Os servidores MCP atuam como uma ponte entre o modelo e seu ambiente local ou outros serviços, como APIs.