Questa pagina è tradotta dalla documentazione inglese. Comandi, identificatori ed esempi restano invariati. Runtime 7.24.4 · SDK 2.6.7. Testo inglese

Domande su file sorgente fissi

Stato: sorgente attuale Ambito: comando di domande a contesto fisso di AX Trust Ultima revisione: 2026-09-18 Responsabile: manutentori del runtime di AX Code

Usa ax-code ask per fare una domanda autonoma su codice o documentazione selezionati in modo esplicito, attraverso una connessione AX Trust già esistente:

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

Sostituisci provider e modello con un modello autorizzato sulla tua connessione AX Trust. Il provider deve essere una connessione AX Trust. L’impostazione di affinità di sessione options.axTrust non abilita né disabilita questo comando. Il comando rilegge il file a ogni invocazione, fornisce il contenuto completo come contesto fisso e aggiunge il contratto di cache semantica del gateway. Non serve aggiungere intestazioni né installare embedding. AX Trust deve avere la funzionalità abilitata per il tuo pool e per il runtime; altrimenti può restituire una risposta ordinaria.

Fai una parafrasi con gli stessi file e le stesse opzioni:

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

La risposta va su stdout; stderr riporta AX Trust cache: MISS, HIT, EXACT_HIT, BYPASS oppure UNREPORTED. HIT significa che il gateway ha riportato un riutilizzo semantico; EXACT_HIT significa che il namespace esatto ha coinciso. UNREPORTED significa che il server non ha fornito un’intestazione di cache riconosciuta. Un bypass non viene ritentato per forzare un hit. Aggiungi --json per la risposta, l’identità di provider e modello, il digest del contesto, lo stato della cache, l’id di richiesta e il punteggio facoltativi e l’uso, quando sono davvero riportati a monte. Le risposte in cache non devono includere l’uso; un uso assente non è una stima di risparmio.

Ripeti --file per includere contesto aggiuntivo:

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?"

Seleziona tutte le dipendenze necessarie per rispondere alla domanda. Il comando non invia cronologia della conversazione, istruzioni di repository scoperte, strumenti, risultati di ricerca né esecuzione di test. Non modifica file e non esegue comandi. Una nuova invocazione legge i byte correnti; codice o opzioni cambiati producono un contesto fisso diverso. Un file può cambiare dopo essere stato letto, quindi la risposta descrive l’istantanea fornita. Usa il normale ax-code run oppure la TUI per indagini in tempo reale, modifiche e test.

Limiti: da 1 a 14 file regolari UTF-8 distinti dentro l’albero della directory corrente, 96 KiB di contenuto file combinato e 128 KiB dopo la codifica della richiesta. Il contesto non viene mai troncato. I symlink non possono uscire dalla directory. Si applicano i permessi di lettura dell’agente predefinito configurato; un rifiuto o una domanda non risolta si fermano prima del trasporto verso il modello. Seleziona file consentiti oppure usa una sessione normale con approvazione.

La domanda deve stare su una sola riga, al massimo 1024 byte UTF-8. Metti il codice inline nei file, non nella domanda. Il limite di output è da 1 a 4096 token, predefinito 512; la temperatura è fissata a zero. Le richieste non sono in streaming, hanno una scadenza di 90 secondi e non ripiegano su un modello diverso. Le risposte incomplete o azionabili vengono rifiutate. Domande simili possono comunque avere significati diversi: aderisci soltanto per le domande la cui risposta dipende dal contenuto fisso selezionato.

Nella TUI, digita /ask oppure seleziona Chiedi sui file fissi dalla tavolozza dei comandi. Usa il modello attualmente selezionato. Inserisci un percorso relativo per riga (incolla più righe per selezionare più file), poi inserisci la domanda. La finestra mostra la directory del server, la risposta e lo stato reale della cache. Premi r per fare un’altra domanda con la stessa selezione di file; il server rilegge quei file. Escape chiude la finestra e annulla una richiesta in attesa. I risultati restano nella finestra e non vengono inseriti nella sessione di programmazione né eseguiti come strumenti. I client TUI collegati richiedono un server con l’endpoint di contesto fisso.