Tehisintellekti agentide integreerimise ülevaade

rdc on agenditega arvestav juba põhimõtteliselt. Claude Code, Cursor, Cline: iga AI-assistent, mis kutsub rdc alamshell’is, saab struktureeritud JSON-väljundi, masintöötlemiseks sobivad veateated ja turvamehhanismid, mida autonoomseks Rediacc infrastruktuuri haldamiseks vajatakse. Nii integreerimine toimib.

Miks isehostatav + AI agendid

Rediacc arhitektuur on loodud agentidega hästi toimima:

CLI-esmane: Kõik toimingud on rdc käsud, graafilist liidest pole vaja
SSH-põhine: Protokoll, mida agendid treeningandmetest kõige paremini tunnevad
JSON-väljund: Kõik käsud toetavad --output json ühtse ümbrikuga
Dockeri isoleerimine: Iga repositoorium saab oma daemoni ja võrgunimeruumi
Skriptitav: --yes jätab kinnitused vahele, --dry-run näitab eelvaate hävitavatest toimingutest

Integreerimislähenemised

1. AGENTS.md / CLAUDE.md mall

Kiireim viis alustamiseks. Kopeeri meie AGENTS.md mall oma projekti juurekausta:

CLAUDE.md Claude Code’i jaoks
.cursorrules Cursori jaoks
.windsurfrules Windsurf’i jaoks

Lisa see faili ja agendil on olemas täielik käsuviide, arhitektuuri kontekst ja konventsioonid, mida ta vajab, et ilma arvamiseta töötada.

2. JSON-väljundi konveier

Kui agendid kutsuvad rdc alamshell’is, lülitub väljund automaatselt JSON-ile (mitte-TTY tuvastus). Iga JSON-vastus kasutab ühtset ümbrikku:

{
  "success": true,
  "command": "machine query",
  "data": { ... },
  "errors": null,
  "warnings": [],
  "metrics": { "duration_ms": 42 }
}

Veastavused sisaldavad välju retryable ja guidance:

{
  "success": false,
  "errors": [{
    "code": "NOT_FOUND",
    "message": "Machine \"prod-2\" not found",
    "retryable": false,
    "guidance": "Verify the resource name with \"rdc machine query\" or \"rdc config repository list\""
  }]
}

3. Agendi võimaluste avastamine

Alamkäsk rdc agent pakub struktureeritud introspektsiooni:

# Loetleb kõik käsud argumentide ja valikutega
rdc agent capabilities

# Näitab konkreetse käsu üksikasjalikku skeemi
rdc agent schema --command "machine query"

# Täidab käsu JSON-sisendiga
echo '{"name": "prod-1"}' | rdc agent exec "machine query"

CLI viide: rdc agent capabilities · rdc agent schema

Agentidele mõeldud põhilipud

Lipp	Eesmärk
`--output json` / `-o json`	Masintöötlemiseks sobiv JSON-väljund
`--yes` / `-y`	Jätab interaktiivsed kinnitused vahele
`--quiet` / `-q`	Peidab informatiivsed stderr-väljundid
`--fields name,status`	Piirab väljundit konkreetsete väljadega
`--dry-run`	Näitab hävitavate toimingute eelvaate ilma neid täitmata

Ohutus ja turvamehhanismid

CLI ei kohtle agente samamoodi nagu inimest terminali taga. Tundlikud toimingud nõuavad tõendit, et tead juba praegust olekut (lipp --current), interaktiivsed redigeerimisvoood lükatakse vaikimisi tagasi ja iga tagasilükkamine logitakse auditisse. Viide AI agendi ohutus ja turvamehhanismid katab täieliku tulemüüri tabeli, teadmisvärava mudeli, REDIACC_ALLOW_CONFIG_EDIT ulatuse ülekattena ja räsiahelaga auditi logi.

Järgmised sammud

AI agendi ohutus ja turvamehhanismid, mida agendid saavad ja ei saa teha, teadmisvärav, auditi logi
Claude Code seadistusjuhend, samm-sammult Claude Code’i seadistamine
Cursor seadistusjuhend, Cursori IDE integreerimine
JSON-väljundi viide, täielik JSON-väljundi dokumentatsioon
AGENTS.md mall, kopeerimiseks valmis agendi seadistuse mall