Vai al contenuto

Codebase Index

In questa pagina

Panoramica

Codebase Index permette alla chat IA di cercare nel progetto aperto per significato anziché per testo esatto. Una volta creato l'indice, puoi porre domande come "dove vengono aperte le connessioni OPC UA?" e l'assistente trova il codice più pertinente, ordinato per somiglianza, e risponde partendo da quello. Funziona sia con il codice PLC sia con i linguaggi di uso generale della tua area di lavoro. Per il codice PLC copre i file SCL (.scl), i file Structured Text (.st) e le esportazioni PLCopenXML (.xml), e li suddivide in blocchi, metodi, proprietà, tipi di dati e liste di variabili globali, così una ricerca trova il blocco esatto anziché un intero file. Gli altri file XML non vengono indicizzati. I file PLC fino a 16 MB vengono indicizzati, quindi l'esportazione di un intero progetto è coperta; gli altri file più grandi di 1 MB vengono saltati.

L'indice è local-first: il tuo codice viene trasformato in una forma ricercabile da un endpoint di embedding che configuri tu (di solito un server di modelli in esecuzione sul tuo computer) e il risultato viene salvato in locale. Con un endpoint locale, nulla lascia il tuo computer. Codebase Index è una funzionalità Pro e resta disattivato finché non lo attivi.

Configurazione

  1. Apri le impostazioni di AnyAutomation (Ctrl+,) e seleziona la categoria Codebase Index (l'icona del database).
  2. Attiva l'opzione Attiva indicizzazione.
  3. Inserisci l'URL di embedding (l'indirizzo di un endpoint di embedding compatibile con OpenAI, ad esempio un server con un modello locale) e il Modello di embedding da usare. Aggiungi una Chiave API se il tuo endpoint la richiede.
  4. (Facoltativo) In Archiviazione, scegli l'Archivio vettoriale: LanceDB (un archivio locale, il predefinito, senza server) oppure Qdrant (un server esterno, per indici più grandi o condivisi). Per Qdrant, compila l'URL Qdrant e, se necessario, la Chiave API Qdrant.

La sezione Ricerca e ottimizzazione ti permette di regolare quanti risultati restituisce una ricerca e quanto deve essere vicina una corrispondenza. La sezione Reranking è facoltativa: indirizza l'URL del reranker a un server di reranking (e compila Modello di reranking / Chiave API del reranker se servono) per riordinare i risultati con una pertinenza più precisa, oppure lascialo vuoto per saltare il reranking. Ogni impostazione viene salvata automaticamente.

Ambito della configurazione

In cima alla pagina delle impostazioni di Codebase Index, un interruttore Globale | Locale stabilisce quali impostazioni stai modificando:

  • Globale: vale per ogni area di lavoro che apri.
  • Locale: vale solo per il progetto corrente. Disattivato quando nessuna cartella è aperta.

La chiave API e gli indirizzi degli endpoint restano sempre globali e non possono essere sovrascritti per singolo progetto. Un piccolo badge accanto a ogni campo (PREDEFINITO, LOCALE o GLOBALE) mostra da dove proviene il valore corrente, e una freccia di ripristino riporta un campo al valore predefinito.

Attivando l'indicizzazione nell'ambito Globale si indicizza ogni area di lavoro che apri; attivandola solo nell'ambito Locale si indicizza soltanto quel progetto.

Indicizzazione

Per creare o aggiornare l'indice del progetto aperto, esegui Codebase Index: indicizza area di lavoro dal riquadro comandi (Ctrl+Shift+P), oppure fai clic sull'icona del database nella casella di input della chat e scegli Indicizza area di lavoro.

Quando l'indicizzazione è attivata a livello globale, Studio indicizza in background anche ogni cartella che apri. Basta aver contrassegnato l'area di lavoro come attendibile. Mentre un'indicizzazione in background è in corso, nella barra di stato compare un indicatore Indexing Codebase…; altrimenti la barra di stato mostra una voce Codebase Index su cui puoi fare clic per le azioni rapide.

Cercare dalla chat IA

Con l'indice creato, l'assistente lo consulta automaticamente tramite lo strumento Semantic Code Search ogni volta che fai domande sul tuo codice. Puoi anche richiamarlo esplicitamente in un messaggio con #semantic_code_search. Ogni risultato include il frammento di codice trovato, il suo file e l'intervallo di righe, e un punteggio di pertinenza, così l'assistente risponde partendo dal tuo codice reale e non a memoria.

Attiva Auto-contesto nelle impostazioni di Codebase Index perché Studio alleghi automaticamente a ogni messaggio della chat il codice più pertinente: mentre scrivi, le corrispondenze migliori compaiono come chip rimovibili sopra il campo di input, e puoi togliere quelle che non vuoi prima dell'invio. Usa Risultati max auto-contesto per stabilire quante ne vengono allegate.

L'auto-contesto funziona anche nella Finestra Agenti (la finestra separata per eseguire le sessioni degli agenti): mentre scrivi un nuovo prompt per il progetto scelto lì, gli stessi chip rimovibili si allegano sopra il messaggio, e una piccola icona di stato accanto alla casella del messaggio mostra se l'indice è inattivo, al lavoro o non disponibile.

Stato e gestione

  • La voce Codebase Index nella barra di stato e l'icona del database nella casella di input della chat aprono un menu rapido: Indicizza area di lavoro, Cancella indice o Apri impostazioni.
  • Codebase Index: cancella indice rimuove l'indice salvato del progetto corrente.
  • Codebase Index: mostra stato apre lo stesso menu rapido dal riquadro comandi.

Note

  • Codebase Index indicizza solo una cartella locale che hai aperto, e l'indicizzazione in background viene eseguita solo per un'area di lavoro che hai contrassegnato come attendibile.
  • Se l'indicizzazione è disattivata, oppure l'URL di embedding e il modello non sono impostati, i comandi e lo strumento della chat ti indicano cosa configurare.
  • La funzionalità richiede una licenza Pro o superiore.