Skip to Content
Guia do DesenvolvedorFerramentasIntrodução

Ferramentas do Qwen Code

O Qwen Code inclui ferramentas integradas que o modelo usa para interagir com seu ambiente local, acessar informações e executar ações. Essas ferramentas ampliam os recursos da CLI, permitindo que ela 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 que sejam 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:

  • Acessar informações locais: As ferramentas permitem que o modelo acesse seu sistema de arquivos local, leia o conteúdo de arquivos, liste diretórios, etc.
  • Executar comandos: Com ferramentas como run_shell_command, o modelo pode executar comandos de shell (com as medidas de segurança adequadas e confirmação do usuário).
  • Interagir com a web: As ferramentas podem buscar conteúdo de URLs.
  • Executar ações: As ferramentas podem modificar arquivos, criar novos arquivos ou realizar outras ações no seu sistema (novamente, geralmente com salvaguardas).
  • Fundamentar respostas: Ao usar ferramentas para buscar dados locais ou em tempo real, as respostas podem ser mais precisas, relevantes e fundamentadas no seu contexto real.

Como usar as ferramentas do Qwen Code

Para usar as ferramentas do Qwen Code, forneça um prompt à CLI. O processo funciona da seguinte forma:

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

Normalmente, você verá mensagens na CLI indicando quando uma ferramenta está sendo chamada e se ela foi bem-sucedida 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 foco em segurança. O Qwen Code normalmente:

  • Exigir confirmação: Exibir um prompt antes de executar operações potencialmente sensíveis, mostrando qual ação está prestes a ser realizada.
  • Utilizar sandboxing: Todas as ferramentas estão sujeitas a restrições impostas pelo sandboxing (consulte Sandboxing no Qwen Code). Isso significa que, ao operar em um sandbox, quaisquer ferramentas (incluindo servidores MCP) que você desejar usar devem estar disponíveis dentro do ambiente do sandbox. Por exemplo, para executar um servidor MCP por meio 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 os prompts de confirmação com atenção antes de permitir que uma ferramenta prossiga.

Saiba mais sobre as ferramentas do Qwen Code

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

Além disso, essas ferramentas incorporam:

Last updated on
SDK em Java (versão alfa)Sistema de Arquivos