Files
seon f30af2a4c3 feat(ai): add AI VM services (diagnosis agent, pgvector RAG, Discord HITL bot) and harness approval endpoints
실험 설계서 6장(WP-12)의 AI VM 2층 구현.
- cmd/agent: 하네스 /diagnose 수신 → OpenAI Responses API 함수 호출 루프(읽기 전용 도구 7종:
  query_metrics, query_logs, get_probe_status, get_k8s, get_gcp_instances, get_aws_state,
  search_runbooks) → strict 스키마 submit_diagnosis(6.3) → 하네스 /proposals 등록 + HITL 게시,
  또는 신뢰도 0.5 미만·escalate 시 3층 큐 에스컬레이션. 세션·프롬프트 버전·러너북 벡터는
  pgvector(ai 스키마)에 저장. 라벨·조치 enum은 하네스 /scenarios·/actions/catalog에서 갱신.
- cmd/hitl: Discord Gateway 봇(intents GUILDS만). 승인/거부 버튼(custom_id approve:/reject:<token>),
  3초 내 DEFERRED_UPDATE_MESSAGE, 승인 시 하네스 승인 → /actions/execute → 원 메시지 편집,
  15분 무응답 시 에스컬레이션 채널로 이동. 재기동 시 미결 제안 타이머 복원.
- harness: POST /proposals/{token}/approve, /reject 추가. 제안은 진단 시점에 등록하고 승인은
  버튼 시점에 기록해 MTTA(승인-제안)가 실제 대기 시간이 되도록 함.
OpenAI·Discord 토큰은 Secret Manager 파일로만 읽고 코드·저장소에 두지 않는다.
2026-10-08 01:36:10 +09:00

15 lines
1.5 KiB
Markdown

# ai
AI VM services of the self-healing lab (experiment design 6). Module `github.com/selfheal-lab/selfheal-lab-apps/ai`.
| command | role | port |
|---|---|---|
| `cmd/agent` | `POST /diagnose`: Responses API tool loop over the read-only tools (`internal/tools`, design 6.2), strict `submit_diagnosis` (design 6.3, `internal/diag`), sessions and prompt versions in pgvector (`internal/rag`), then proposal + HITL post or escalation (design 6.5/6.6, `internal/agent`) | 8080 |
| `cmd/hitl` | Discord gateway bot (`internal/hitl`): Approve/Reject buttons, harness approval + execution, expiry to the escalation channel, escalation threads with the runbook | 8081 |
Contracts: harness `POST /diagnose {"alert","run_id","scenario_id"}` -> diagnosis fields at top level plus `session_id`, `model`, `prompt_version`, `disposition`. Harness side: `POST /proposals` (registers the proposal at diagnosis time, returns the approval token), `POST /proposals/{token}/approve`, `POST /proposals/{token}/reject`, `POST /actions/execute`.
OpenAI: `POST /v1/responses` with function tools (`strict: true`, every property required, `additionalProperties: false`), `previous_response_id` chaining, `function_call_output` items; embeddings `text-embedding-3-small` (1536). Model id from `OPENAI_MODEL`.
Build: `gcloud builds submit ai --project cms-d-414903 --config ai/cloudbuild.yaml --substitutions=_TAG=$(git rev-parse --short HEAD)`. Tests: `cd ai && go test ./...` (mock Responses API and Mimir; no network).