Eseguire un agente di codice IA in modalità headless in CI
Installa il pacchetto oharness ed esegui oharness-headless "<task>": trasmette un evento JSON per riga su stdout ed esce con 1 se l'esecuzione è fallita. In CI nessuno può rispondere a una richiesta di permesso, quindi tutto ciò che chiederebbe viene negato: autorizza in anticipo il lavoro con regole o con --permission-mode.
Aggiornato il
Il comando
oharness-headless -m deepseek/deepseek-v4-flash "run the tests and fix what fails"Il prompt può arrivare da un argomento o da stdin (echo "task" | oharness-headless). -C <dir> imposta la directory di lavoro, -r <id> riprende una sessione e --permission-mode accetta default, acceptEdits, plan, auto o bypassPermissions.
Cosa esce
stdout contiene JSONL e nient'altro, quindi si può passare a jq; la diagnostica va su stderr. Il flusso termina con un evento done che riporta il motivo di arresto, l'utilizzo, il costo e il numero di turni:
{"type":"session","id":"20260808_...","model":"deepseek-v4-flash","cwd":"/repo"}
{"type":"tool_start","toolCallId":"c1","toolName":"grep","title":"grep(build)","input":{...}}
{"type":"text_delta","text":"The build entry point is "}
{"type":"done","stopReason":"end_turn","usage":{...},"costUsd":0.004,"turns":2}Permessi senza una persona
Un'esecuzione che approvasse tutto in silenzio sarebbe più pericolosa senza supervisione che con, quindi la modalità headless fa l'opposto: uno strumento che chiederebbe conferma viene negato e segnalato come evento permission_result. Consenti ciò che serve al job nel file .oharness/settings.json del progetto, dove è revisionabile nel repository:
{
"allow": ["Bash(npm test*)", "Bash(npm run lint*)", "edit", "write"],
"deny": ["Bash(git push*)", "Bash(rm -rf *)", "write(.env*)"]
}deny prevale su ogni modalità, compresa bypassPermissions. Le domande che l'agente porrebbe a un utente ritornano subito con l'istruzione di scegliere un valore predefinito sensato e dichiararlo, e compaiono comunque nel flusso come question_request e question_result.
Credenziali in CI
Usa la variabile della chiave del fornitore come secret della CI: DEEPSEEK_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY e così via. Con il piano ospitato, una chiave creata sul sito va in OHARNESS_API_KEY, e OHARNESS_TEAM addebita l'esecuzione a un team. Il controllo degli aggiornamenti si disattiva automaticamente quando CI è impostata.
Uno step di GitHub Actions
- run: npm install -g oharness
- run: oharness-headless --permission-mode acceptEdits "run npm test and fix failures" > run.jsonl
env:
DEEPSEEK_API_KEY: ${{ secrets.DEEPSEEK_API_KEY }}
- run: jq -r 'select(.type=="done") | .stopReason' run.jsonlDomande frequenti
Come eseguo un agente di codice in modo non interattivo?
Con OHarness, esegui oharness-headless "<task>". Stampa gli eventi dell'agente come JSONL su stdout, scrive la diagnostica su stderr ed esce con codice 1 se l'esecuzione è fallita.
Cosa succede alle richieste di permesso in modalità headless?
Vengono negate e segnalate come eventi permission_result, perché non c'è nessuno a rispondere. Consenti gli strumenti che servono al job con regole di permesso in .oharness/settings.json, oppure scegli una --permission-mode.
Quali modelli possono girare in modalità headless?
Qualsiasi modello che OHarness può raggiungere: Anthropic, OpenAI, Gemini, DeepSeek, qualsiasi endpoint compatibile con OpenAI, o un server locale raggiungibile dal runner. Sceglilo con -m provider/model.