Ferramentas do agente Cortex Code CLI¶

O Cortex Code tem acesso a um conjunto abrangente de ferramentas para operações com arquivos, comandos de shell, acesso à Web e muito mais. Você não precisa instalar nada extra; essas ferramentas já estão integradas ao Cortex Code CLI e prontas para uso. O Cortex Code usa automaticamente as ferramentas apropriadas com base em suas solicitações. Você não precisa invocá-las manualmente; basta descrever o que deseja. Por exemplo:

Read the first 10 lines of the file src/main.py
Search for TODO comments in all Python files
Execute a bash command to list running processes

Copy

Ao criar habilidades personalizadas, você deve especificar as ferramentas que a habilidade pode usar. Consulte Habilidades.

Ferramentas de arquivo¶

Leitura¶

Leia o conteúdo de arquivos do sistema de arquivos local. Oferece suporte a:

Arquivos de texto com números de linha
Imagens (PNG, JPG, etc.) – exibidas visualmente
PDFs – extração página por página
Notebooks Jupyter – células com saídas
Intervalos de linhas: @file.py$10-20

Gravação¶

Crie ou sobrescreva arquivos. Oferece suporte a:

Criação automática de diretórios pai
Rastreamento de alterações de linha para estatísticas de sessão
Sobrescrita de arquivos existentes

Editar¶

Busca e substituição em arquivos. Oferece suporte a:

Substituição exata de cadeias de caracteres
Visualização de diferenças antes das alterações
Oferece suporte a replace_all para substituição global

Glob¶

Encontre arquivos por correspondência de padrões. Exemplos:

Padrão	Descrição
`*/.py`	Todos os arquivos Python
`src/*/.ts`	Arquivos TypeScript no diretório `src/`
`*/test_.py`	Arquivos de teste Python
`!node_modules`	Padrões de exclusão

Grep¶

Busque conteúdo de arquivos usando uma expressão regular. Oferece suporte a:

Busca recursiva
Padrões regex
Detecção de arquivos binários
Modos de saída: conteúdo, arquivos, contagem

Ferramentas de shell¶

Bash¶

Execute comandos de shell. Oferece suporte a:

Saída de streaming
Execução em segundo plano (run_in_background)
Controle de tempo limite (padrão 2 min, máximo 10 min)
Suporte a tempo de execução de sandbox

BashOutput¶

Recupere a saída de um processo de shell em segundo plano.

Filtragem da saída por regex
Verificação de status
Uso com run_in_background

KillShell¶

Encerre a execução de shells em segundo plano.

Ferramentas do agente¶

RunSubagent¶

Inicie subagentes para tarefas especializadas. Tipos:

general-purpose: todas as ferramentas, tarefas de pesquisa
Explore: exploração rápida do código-fonte
Plan: arquitetura e planejamento
Agentes personalizados de .cortex/agents/

Consulte Subagentes para obter mais detalhes.

AskUserQuestion¶

Solicite entrada do usuário durante a execução. Oferece suporte a:

Perguntas de múltipla escolha
Entrada de texto livre
Opções de seleção múltipla

Revisar¶

Inicie um subagente de revisão para garantia de qualidade.

Ferramentas da Web¶

WebSearch¶

Pesquise na Web usando vários mecanismos. Oferece suporte a:

Mecanismos de pesquisa de fallback
Extração de trechos
Cache de resultados
Tempo limite de 30 segundos

Nota

O WebSearch requer a ativação da pesquisa na Web nas configurações do Cortex Code no Snowsight. Consulte Pesquisa na web.

WebFetch¶

Recupere conteúdo de URLs da Web. Oferece suporte a:

Conversão de HTML para texto
Extração de conteúdo
Máximo de 10.000 caracteres
Tempo limite de 30 segundos

Ferramentas Snowflake¶

SnowflakeSqlExecute¶

Execute consultas SQL no Snowflake. Oferece suporte a:

Verificação de permissões
Cache de resultados
Atualização de tokens
Descarregamento de grandes volumes de resultados

SnowflakeObjectSearch¶

Busca semântica para objetos de banco de dados.

Pesquisas	tabelas, exibições, esquemas, bancos de dados, funções
Retornos	nomes, colunas, descrições

SnowflakeProductDocs¶

Busca na documentação do Snowflake. Categorias com suporte:

Guia do usuário
Referência de SQL
Guia do desenvolvedor
Tópicos do Cortex Code

ReflectSemanticModel¶

Valide modelos semânticos do Cortex Analyst. Estágios de validação:

Existência de arquivo
Sintaxe YAML
Validação de esquema
Validação no servidor

SnowflakeMultiCortexAnalyst¶

Execute consultas do Cortex Analyst. Oferece suporte a:

Conversão de linguagem natural para SQL
Suporte a modelos semânticos
Recuperação de consultas verificadas

Ferramentas de dados¶

DataDiff¶

Compare dados entre bancos de dados/tabelas. Oferece suporte a:

Manipulação de conexões Snowflake
Derivação de identificadores de conta
Tempo limite de 300 segundos

NotebookExecute¶

Execute notebooks Jupyter. Oferece suporte a:

Controle de tempo limite
Gerenciamento de kernel
Injeção de parâmetros
Ambientes Python personalizados

NotebookEdit¶

Edite células de notebooks Jupyter. Modos compatíveis:

replace: substituir o conteúdo da célula
insert: adicionar célula
delete: remover célula

Ferramentas do modo de planejamento¶

EnterPlanMode¶

Solicite o modo de planejamento para tarefas complexas. Oferece suporte a:

Fluxo de trabalho de aprovação do usuário
Invocação automática para tarefas com várias etapas

ExitPlanMode¶

Apresente o plano ao usuário e saia do modo de planejamento. Oferece suporte a:

Confirmação do plano
Controle de streaming

Ferramentas de memória¶

Memória¶

Armazene e recupere informações entre as sessões. Comandos compatíveis:

view: visualizar memórias armazenadas
create: armazenar memória nova
str_replace: atualizar memória
insert: adicionar à memória
delete: remover memória
rename: renomear arquivo de memória

Nota

A ferramenta de memória deve ser habilitada definindo a variável de ambiente CORTEX_ENABLE_MEMORY.

Níveis de permissão¶

As ferramentas têm diferentes requisitos de permissão:

Nível	Ferramentas	Comportamento
Seguro	Leitura, Glob, Grep	Aprovado automaticamente
Low	Gravação (novos arquivos)	Geralmente aprovado automaticamente
Medium	Editar, Bash (seguro)	Solicita confirmação no modo de confirmação
High	Bash (arriscado), escrita em SQL	Sempre solicita confirmação
Critical	rm -rf, sudo	Confirmação extra

Consulte Segurança para obter mais detalhes.