Impostazioni del progetto

Le Impostazioni del progetto sono il luogo in cui configuri i valori predefiniti e le integrazioni a livello di progetto che influenzano tutte le sandbox, i workflow e le issue session. La pagina delle impostazioni è organizzata in schede, ciascuna delle quali copre un aspetto diverso della configurazione del progetto. L’accesso alle impostazioni richiede il ruolo Admin o Owner.

Vai alle Impostazioni del progetto dalla parte inferiore della barra laterale (l’icona della chiave inglese) oppure direttamente su /p/{projectId}/settings.

Configurazione delle chiavi API

CodeCourier richiede chiavi API per i servizi esterni con cui si integra. Le chiavi vengono configurate per progetto, il che significa che progetti diversi possono usare account API diversi. Tutte le chiavi sono criptate a riposo nel database e nell’interfaccia vengono mostrati solo gli ultimi quattro caratteri.

Chiavi richieste

Chiavi facoltative

Configurazione del prompt di sistema

Il Prompt di sistema della sandbox è un prompt predefinito iniettato in ogni sessione di sandbox del progetto. Stabilisce il comportamento di base per tutti gli agenti IA, incluse le istruzioni per lavorare nell’ambiente di sandbox E2B, le preferenze di gestione dei pacchetti, le convenzioni del file system e le regole del workflow Git.

Il prompt di sistema predefinito include istruzioni critiche specifiche della sandbox come:

• Associare i server di dev a 0.0.0.0 per l’accessibilità pubblica
• Avviare i server in background con nohup
• Usare la directory di base /home/user/
• Costruire l’URL pubblico dall’ID della sandbox e dalla porta
• Convenzioni di commit Git e configurazione dell’autenticazione

Puoi personalizzare il prompt di sistema per aggiungere regole specifiche del progetto che dovrebbero applicarsi a tutte le sessioni, indipendentemente dalla persona o dal workflow in esecuzione.

Template CLAUDE.md

Il campo CLAUDE.md ti consente di definire un template per il file CLAUDE.md che viene scritto in ogni sandbox. Questo file fornisce contesto a livello di progetto all’agente IA, incluse le decisioni architetturali, gli standard di codifica, le preferenze di dipendenze e altre conoscenze che dovrebbero persistere tra le sessioni.

Pensa a CLAUDE.md come alla « conoscenza istituzionale » del progetto a cui ogni agente dovrebbe avere accesso, indipendentemente dal task.

Prompt di issue discovery

Il Prompt di issue discovery configura le istruzioni predefinite usate dalle issue session. Questo prompt viene iniettato quando un agente IA inizia ad analizzare il codebase alla ricerca di issue. Personalizzalo per riflettere le convenzioni di triage delle issue del tuo progetto, le preferenze di priorità e le aree di discovery prioritarie.

Variabili d’ambiente

Puoi definire variabili d’ambiente che vengono iniettate in ogni sessione di sandbox. Sono utili per i valori di configurazione di cui il tuo codebase ha bisogno a runtime:

• Chiave - Il nome della variabile d’ambiente (ad esempio, DATABASE_URL)
• Valore - Il valore della variabile
• Flag secret - Se il valore deve essere mascherato nell’interfaccia

La pagina delle impostazioni supporta due insiemi di variabili d’ambiente:

• Variabili d’ambiente di sandbox - Iniettate nelle sessioni di sandbox di sviluppo
• Variabili d’ambiente di deploy - Usate durante le operazioni di deploy

Skills e Commands

Le impostazioni del progetto includono la possibilità di selezionare quali skill e command sono disponibili a livello di progetto. Le skill sono pacchetti di conoscenza di dominio (file di riferimento, best practice, documenti API) e i command sono template di prompt riutilizzabili. Selezionarli a livello di progetto li rende disponibili a tutte le personas e sessioni del progetto.

Puoi anche selezionare degli script - script shell eseguibili che possono essere iniettati negli ambienti di sandbox per attività di configurazione comuni.

Configurazione del learning

Il sistema di learning cattura pattern, insidie e best practice dalle sessioni di sandbox e li rende disponibili per i run futuri. Le impostazioni del progetto controllano:

• ID del template di learning - Il template di sandbox usato per l’estrazione dei learning
• Modello di learning - Quale modello IA estrae i learning dalle trascrizioni delle sessioni
• ID del template di merging - Il template usato per unire le modifiche al codice dai run completati
• Modello di merging - Quale modello gestisce le operazioni di merge

Configurazione Git

Per i progetti che creano commit Git e pull request, puoi configurare:

• URL del repository GitHub - Il repository collegato a questo progetto (impostato a livello di progetto)
• Nome del commit Git - Il nome dell’autore usato nei commit creati dall’agente IA
• Email del commit Git - L’email dell’autore usata nei commit

Queste impostazioni garantiscono che tutti i commit generati dall’IA siano attribuiti correttamente e seguano le convenzioni Git del tuo team.

Chiavi Convex

Se il tuo progetto usa Convex come backend (come fa CodeCourier stesso), puoi configurare:

• Chiave di deploy Convex - Usata per distribuire le funzioni Convex dalla sandbox
• Chiave di dev Convex - Usata per le operazioni Convex in modalità sviluppo

Queste chiavi consentono all’agente IA di distribuire e testare le modifiche al backend Convex direttamente dall’ambiente di sandbox.

Credenziali utente di test

Per i progetti che richiedono test autenticati, puoi memorizzare le credenziali utente di test:

• Email - Indirizzo email dell’account di test
• Password - Password dell’account di test

Queste credenziali vengono rese disponibili alle sessioni di sandbox per il testing end-to-end automatizzato, consentendo agli agenti di accedere all’applicazione e testare le funzionalità autenticate.

Configurazioni di sessione

Oltre ai valori predefiniti globali del progetto, CodeCourier fornisce schede di configurazione dedicate per ciascuno dei sei tipi di sessione che alimentano la pipeline di workflow IA. Ogni scheda di configurazione ti consente di configurare lo strumento CLI, il modello, lo sforzo di ragionamento, il Context Document collegato e gli Asset selezionati (Skills, Commands e Scripts) per quel tipo di sessione specifico. Le modifiche alla configurazione di un tipo di sessione si applicano a tutte le nuove sessioni di quel tipo a livello di progetto, a meno che una persona non le sovrascriva.

Configurazione Answering

Situata su /p/{id}/answering-setup. Configura l’ Answering Agent - il tipo di sessione che risponde a domande in linguaggio naturale sul codebase e sul progetto. Campi:

• Strumento CLI - Quale CLI di agente di coding usare (Claude Code, OpenCode, Codex)
• Modello - Il modello LLM specifico per le sessioni answering
• Sforzo di ragionamento - Profondità di ragionamento (none, low, medium, high, max)
• Context - Il Context Document iniettato per impostazione predefinita nelle sessioni answering
• Skills, Commands, Scripts - Asset predefiniti disponibili per le sessioni answering

Configurazione Issues

Situata su /p/{id}/issues-setup. Configura l’ Issue Discovery Agent - il tipo di sessione che analizza il codebase e genera un elenco strutturato di issue, bug e opportunità di miglioramento. Campi:

• Strumento CLI - Quale CLI di agente di coding usare
• Modello - Il modello LLM specifico per le sessioni di issue discovery
• Sforzo di ragionamento - Profondità di ragionamento
• Context - Il Context Document iniettato per impostazione predefinita nelle sessioni di issue discovery
• Skills, Commands, Scripts - Asset predefiniti disponibili per le sessioni di issue discovery

Configurazione Learning

Situata su /p/{id}/learning-setup. Configura l’ Learning Extraction Agent - il tipo di sessione che legge le trascrizioni delle sessioni completate ed estrae da esse record di learning strutturati. Campi:

• Strumento CLI - Quale CLI di agente di coding usare
• Modello - Il modello LLM specifico per l’estrazione dei learning
• Sforzo di ragionamento - Profondità di ragionamento
• Context - Il Context Document iniettato per impostazione predefinita nelle sessioni di learning
• Skills, Commands, Scripts - Asset predefiniti disponibili per le sessioni di learning

Configurazione Merging

Situata su /p/{id}/merging-setup. Configura il Merge Agent - il tipo di sessione responsabile dell’unione delle modifiche al codice dai run di workflow completati nel branch principale. Campi:

• Strumento CLI - Quale CLI di agente di coding usare
• Modello - Il modello LLM specifico per le operazioni di merge
• Sforzo di ragionamento - Profondità di ragionamento (uno sforzo maggiore aiuta a risolvere conflitti di merge complessi)
• Context - Il Context Document iniettato per impostazione predefinita nelle sessioni di merging
• Skills, Commands, Scripts - Asset predefiniti disponibili per le sessioni di merging

Configurazione Evaluator

Situata su /p/{id}/evaluator-setup. Configura il Quality Evaluator - un tipo di sessione che valuta e assegna un punteggio all’output dell’agente rispetto a criteri di qualità definiti. L’Evaluator viene usato quando vuoi una misurazione quantitativa della qualità invece di un verdetto binario superato/fallito. Campi:

• Strumento CLI - Quale CLI di agente di coding usare
• Modello - Il modello LLM specifico per le sessioni di valutazione
• Sforzo di ragionamento - Profondità di ragionamento
• Context - Il Context Document iniettato per impostazione predefinita nelle sessioni evaluator
• Skills, Commands, Scripts - Asset predefiniti disponibili per le sessioni evaluator

Configurazione Judge

Situata su /p/{id}/judge-setup. Configura l’ Output Judge - un tipo di sessione che confronta più output dell’agente fianco a fianco e seleziona il migliore. Il Judge viene usato nelle pipeline di valutazione in cui vengono generate diverse varianti di una soluzione e vuoi una selezione automatizzata del vincitore. Campi:

• Strumento CLI - Quale CLI di agente di coding usare
• Modello - Il modello LLM specifico per le sessioni judge
• Sforzo di ragionamento - Profondità di ragionamento (uno sforzo elevato è consigliato per confronti sfumati)
• Context - Il Context Document iniettato per impostazione predefinita nelle sessioni judge
• Skills, Commands, Scripts - Asset predefiniti disponibili per le sessioni judge

Campi aggiuntivi delle impostazioni del progetto

Le seguenti impostazioni sono disponibili nello schema delle Impostazioni del progetto ma non sono trattate nelle sezioni precedenti. Controllano il deploy, il testing, il ciclo di vita e i comportamenti avanzati dell’infrastruttura.

Variabili d’ambiente di deploy

Oltre alle variabili d’ambiente di sandbox (usate nelle sessioni di sviluppo), puoi definire un insieme separato di Variabili d’ambiente di deploy per i contesti di deploy e produzione. Queste vengono memorizzate criptate e vengono iniettate solo nelle sessioni che eseguono operazioni di deploy - non sono visibili nelle sessioni di sandbox standard.

Usa le variabili d’ambiente di deploy per chiavi API di produzione, URL di database di produzione, token CDN e altre credenziali che non dovrebbero mai essere presenti nelle sandbox di sviluppo. Il formato chiave/valore è identico a quello delle variabili d’ambiente di sandbox, con lo stesso supporto per il mascheramento dei segreti.

Credenziali utente di test

Per i progetti che richiedono test end-to-end autenticati, puoi memorizzare le Credenziali utente di test nelle Impostazioni del progetto. Queste vengono rese disponibili alle sessioni di sandbox in modo che gli agenti possano accedere all’applicazione come utente di test ed esercitare le funzionalità autenticate.

• Email - Indirizzo email dell’account di test
• Password - Password dell’account di test (memorizzata criptata)

Le credenziali vengono iniettate come variabili d’ambiente nella sandbox in modo che gli agenti e gli script di test possano richiamarle senza doverle codificare in modo fisso da nessuna parte.

Template di PR

Il campo Template di PR accetta un template markdown usato quando gli agenti creano pull request dai run di workflow. Il template segue lo stesso formato di un file GitHub .github/pull_request_template.md. Quando un agente apre una pull request, questo template viene usato come corpo della PR, precompilato con il contesto rilevante del run di workflow (titolo della issue, riepilogo del prompt, elementi della checklist).

## Summary
<!-- Describe what this PR does and why -->

## Changes
<!-- List the key files and components changed -->

## Testing
- [ ] Unit tests added or updated
- [ ] Build passes (`bun run build`)
- [ ] Lint clean (`bun run lint`)
- [ ] E2E tests pass (if applicable)

## Related Issues
<!-- Link to the issue or task this PR resolves -->

Chiave di deploy Convex

La Chiave di deploy Convex viene usata dagli agenti per distribuire le funzioni Convex dall’interno di una sandbox. Quando è impostata, gli agenti possono eseguire npx convex deploy all’interno della sandbox e la chiave autentica il deploy verso il tuo progetto Convex. Questo abilita workflow end-to-end completamente automatizzati in cui l’agente scrive il codice backend e lo distribuisce in una singola sessione.

Genera una chiave di deploy dalla dashboard Convex nelle impostazioni di deployment del tuo progetto. Le chiavi di deploy sono vincolate a un deployment Convex specifico e dovrebbero usare i permessi minimi richiesti.

Chiave di dev Convex

La Chiave di dev Convex viene usata per accedere a Convex in modalità sviluppo dall’interno delle sandbox. A differenza della chiave di deploy (che punta ai deployment di produzione), la chiave di dev si connette al tuo deployment di sviluppo Convex, consentendo agli agenti di leggere e scrivere dati nel database di dev durante le sessioni di sviluppo.

Pausa automatica

L’interruttore Pausa automatica controlla se le sandbox inattive nel progetto vengono automaticamente messe in pausa dopo un periodo di inattività. Quando è abilitato, una sandbox che non ha ricevuto input dall’utente né prodotto nuovo output per un periodo configurabile viene automaticamente sospesa per conservare le risorse.

Le sandbox in pausa preservano lo stato del loro file system e possono essere riprese. La pausa automatica è consigliata per i progetti in cui le sessioni di sandbox vengono spesso lasciate in esecuzione per errore, poiché previene costi incontrollati dovuti a sandbox E2B inattive.

Durata massima della pausa

Il campo Durata massima della pausa imposta per quanto tempo una sandbox in pausa viene conservata prima di essere terminata definitivamente. Una volta che una sandbox è stata in pausa più a lungo di questa durata, viene automaticamente terminata e il suo stato viene scartato. I valori validi vanno da minuti a ore, a seconda del tuo piano.

Impostare una durata massima della pausa più breve riduce i costi terminando prima le sandbox dimenticate. Impostare una durata più lunga dà ai membri del team più tempo per tornare a una sandbox in pausa e riprendere il lavoro. Il valore giusto dipende dalle abitudini di lavoro del tuo team.

Logo del progetto

Puoi caricare un logo personalizzato per il progetto. Il logo viene mostrato nel rail dei progetti della barra laterale e aiuta a distinguere visivamente i progetti quando sei membro di più team. Se non viene caricato alcun logo, il progetto mostra un badge colorato con le iniziali derivato dal nome del progetto.

Prossimi passi