Agent kodowania AI w trybie headless w CI

Zainstaluj pakiet oharness i uruchom oharness-headless "<task>": strumieniuje on jedno zdarzenie JSON na linię na stdout i kończy się kodem 1, jeśli przebieg się nie powiódł. W CI nikt nie odpowie na pytanie o zgodę, więc wszystko, co wymagałoby pytania, jest odrzucane — autoryzuj pracę z góry regułami lub --permission-mode.

Zaktualizowano

Polecenie

oharness-headless -m deepseek/deepseek-v4-flash "run the tests and fix what fails"

Prompt może pochodzić z argumentu albo ze stdin (echo "task" | oharness-headless). -C <dir> ustawia katalog roboczy, -r <id> kontynuuje sesję, a --permission-mode przyjmuje jedną z wartości default, acceptEdits, plan, auto lub bypassPermissions.

Co wychodzi

stdout to wyłącznie JSONL, więc można go przekazać do jq; diagnostyka trafia na stderr. Strumień kończy się zdarzeniem done z powodem zatrzymania, zużyciem, kosztem i liczbą tur:

{"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}

Uprawnienia bez człowieka

Przebieg, który po cichu zatwierdzałby wszystko, byłby bez nadzoru groźniejszy niż pod nadzorem, więc tryb headless robi odwrotnie: narzędzie, które wymagałoby pytania, jest odrzucane i zgłaszane jako zdarzenie permission_result. Zezwól na to, czego zadanie potrzebuje, w pliku .oharness/settings.json projektu, gdzie można to przejrzeć w repozytorium:

{
  "allow": ["Bash(npm test*)", "Bash(npm run lint*)", "edit", "write"],
  "deny":  ["Bash(git push*)", "Bash(rm -rf *)", "write(.env*)"]
}

deny wygrywa z każdym trybem, także z bypassPermissions. Pytania, które agent zadałby użytkownikowi, wracają od razu z instrukcją, by wybrać rozsądną wartość domyślną i to zaznaczyć, a w strumieniu nadal pojawiają się jako question_request i question_result.

Dane uwierzytelniające w CI

Użyj zmiennej z kluczem dostawcy jako sekretu CI — DEEPSEEK_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY itd. W planie hostowanym klucz utworzony na stronie trafia do OHARNESS_API_KEY, a OHARNESS_TEAM przypisuje koszt przebiegu do zespołu. Sprawdzanie aktualizacji wyłącza się automatycznie, gdy ustawiona jest zmienna CI.

Krok w 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.jsonl

Częste pytania

Jak uruchomić agenta kodowania w trybie nieinteraktywnym?

W OHarness uruchom oharness-headless "<task>". Wypisuje zdarzenia agenta jako JSONL na stdout, diagnostykę zapisuje na stderr i kończy się kodem 1, jeśli przebieg się nie powiódł.

Co dzieje się z pytaniami o zgodę w trybie headless?

Są odrzucane i zgłaszane jako zdarzenia permission_result, bo nie ma nikogo, kto by odpowiedział. Zezwól na narzędzia, których zadanie potrzebuje, regułami uprawnień w .oharness/settings.json albo wybierz --permission-mode.

Jakie modele mogą działać w trybie headless?

Każdy model, do którego OHarness ma dostęp: Anthropic, OpenAI, Gemini, DeepSeek, dowolny endpoint zgodny z OpenAI albo lokalny serwer osiągalny z runnera. Wybierz go przez -m provider/model.

Powiązane