Esta página é uma tradução da documentação em inglês. Comandos, identificadores e exemplos permanecem iguais. Runtime 7.24.4 · SDK 2.6.7. Original em inglês

Perguntas sobre arquivos de fonte fixos

Status: Código-fonte atual Escopo: comando de pergunta de contexto fixo do AX Trust Última revisão: 2026-09-18 Responsável: mantenedores do runtime do AX Code

Use ax-code ask para fazer uma pergunta independente sobre código ou documentação selecionados de forma explícita, por uma conexão AX Trust existente:

ax-code ask --file src/value.py \
  --model defai-01-ax-trust-com/openai/gpt-oss-120b \
  "What does this function return?"

Substitua o provedor e o modelo por um modelo autorizado na sua conexão AX Trust. O provedor precisa ser uma conexão AX Trust. O ajuste de afinidade de sessão options.axTrust não ativa nem desativa este comando. O comando lê o arquivo de novo em cada invocação, fornece o conteúdo completo como contexto fixo e acrescenta o contrato de cache semântico do gateway. Você não precisa acrescentar cabeçalhos nem instalar embeddings. O AX Trust precisa ter o recurso ativado para o seu pool e runtime; caso contrário, pode devolver uma resposta comum.

Faça uma paráfrase com os mesmos arquivos e opções:

ax-code ask --file src/value.py \
  --model defai-01-ax-trust-com/openai/gpt-oss-120b \
  "What does the function return?"

A resposta vai para stdout; stderr relata AX Trust cache: MISS, HIT, EXACT_HIT, BYPASS ou UNREPORTED. HIT significa que o gateway relatou reutilização semântica; EXACT_HIT significa que o namespace exato coincidiu. UNREPORTED significa que o servidor não forneceu um cabeçalho de cache reconhecido. Um desvio não é tentado de novo para forçar um acerto. Acrescente --json para a resposta, a identidade de provedor e modelo, o digest do contexto, o status do cache, o ID e a pontuação opcionais do pedido e o uso, quando de fato relatados a montante. Respostas em cache não precisam incluir uso; uso ausente não é uma estimativa de economia.

Repita --file para incluir contexto adicional:

ax-code ask --file src/value.py --file docs/value.md \
  --model defai-01-ax-trust-com/openai/gpt-oss-120b \
  --max-tokens 1024 --json \
  "How is the return value determined?"

Selecione todas as dependências necessárias para responder à pergunta. O comando não envia histórico de conversa, instruções de repositório descobertas, ferramentas, resultados de busca nem execução de teste. Ele não edita arquivos nem executa comandos. Uma invocação nova lê os bytes atuais; código ou opções alterados produzem contexto fixo diferente. Um arquivo pode mudar depois de lido, então a resposta descreve o instantâneo fornecido. Use ax-code run normal ou a TUI para investigação ao vivo, edições e testes.

Limites: 1 a 14 arquivos regulares UTF-8 distintos dentro da árvore do diretório atual, 96 KiB de conteúdo combinado de arquivo e 128 KiB depois da codificação do pedido. O contexto nunca é truncado. Links simbólicos não podem escapar do diretório. Aplicam-se as permissões de leitura do agente padrão configurado; uma negação ou uma pergunta sem resolução para antes do transporte do modelo. Selecione arquivos permitidos ou use uma sessão normal com aprovação.

A pergunta precisa ser uma linha, no máximo 1024 bytes UTF-8. Coloque código inline em arquivos, não na pergunta. O limite de saída é 1 a 4096 tokens, padrão 512; temperature fica fixa em zero. Os pedidos não usam streaming, têm prazo de 90 segundos e não recuam para outro modelo. Respostas incompletas ou acionáveis são rejeitadas. Perguntas parecidas ainda podem ter significados diferentes: adira apenas a perguntas cuja resposta dependa do conteúdo fixo selecionado.

Na TUI, digite /ask ou selecione Perguntar sobre arquivos fixos na paleta de comandos. Ela usa o modelo selecionado no momento. Informe um caminho relativo por linha (cole várias linhas para selecionar vários arquivos) e depois informe a pergunta. O diálogo mostra o diretório do servidor, a resposta e o status real do cache. Pressione r para fazer outra pergunta com a mesma seleção de arquivos; o servidor relê esses arquivos. Escape fecha o diálogo e cancela um pedido pendente. Os resultados permanecem no diálogo e não são inseridos na sessão de programação nem executados como ferramentas. Clientes TUI anexados exigem um servidor com o endpoint de contexto fixo.