Passa al contenuto principale Passa alla navigazione Passa al piè di pagina
Programma Design Partner: iscriviti gratis, piano BUSINESS per sempre→

Panoramica sull'integrazione degli agenti AI

Come gli assistenti di programmazione AI come Claude Code, Cursor e Cline si integrano con l'infrastruttura Rediacc per il deployment e la gestione autonoma. È possibile iniziare subito.

Gli assistenti di programmazione AI possono gestire l’infrastruttura Rediacc in modo autonomo tramite la CLI rdc. Questa guida illustra gli approcci di integrazione e come iniziare.

Perché self-hosted e agenti AI

L’architettura di Rediacc è naturalmente compatibile con gli agenti:

  • CLI-first: ogni operazione è un comando rdc, nessuna GUI richiesta
  • Basata su SSH: il protocollo che gli agenti conoscono meglio dai dati di addestramento
  • Output JSON: tutti i comandi supportano --output json con un envelope coerente
  • Isolamento Docker: ogni repository ha il proprio daemon e namespace di rete
  • Scriptabile: --yes salta le conferme, --dry-run mostra in anteprima le operazioni distruttive

Approcci di integrazione

1. Template AGENTS.md / CLAUDE.md

Il modo più rapido per iniziare. Copia il nostro template AGENTS.md nella root del progetto:

  • CLAUDE.md per Claude Code
  • .cursorrules per Cursor
  • .windsurfrules per Windsurf

Questo fornisce all’agente il contesto completo sui comandi disponibili, l’architettura e le convenzioni.

2. Pipeline di output JSON

Quando gli agenti invocano rdc in una subshell, l’output passa automaticamente a JSON (rilevamento non-TTY). Ogni risposta JSON usa un envelope coerente:

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

Le risposte di errore includono i campi retryable e 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. Rilevamento delle capacità dell’agente

Il sottocomando rdc agent fornisce introspezione strutturata:

# Elenca tutti i comandi con argomenti e opzioni
rdc agent capabilities

# Mostra lo schema dettagliato per un comando specifico
rdc agent schema --command "machine query"

# Esegui un comando con stdin JSON
echo '{"name": "prod-1"}' | rdc agent exec "machine query"
Riferimento CLI: rdc agent capabilities · rdc agent schema

Flag chiave per gli agenti

FlagScopo
--output json / -o jsonOutput JSON leggibile dalla macchina
--yes / -ySalta le conferme interattive
--quiet / -qSopprime l’output informativo su stderr
--fields name,statusLimita l’output a campi specifici
--dry-runMostra in anteprima le operazioni distruttive senza eseguirle

Sicurezza e guardrail

La CLI tratta gli agenti AI diversamente dagli esseri umani alla tastiera. Le operazioni sensibili richiedono la prova di una conoscenza previa (il flag --current), i flussi con editor interattivo vengono rifiutati per impostazione predefinita e ogni rifiuto viene registrato nel log di audit. Il riferimento Sicurezza e guardrail degli agenti AI descrive la tabella completa del firewall, il modello knowledge-gate, il scope-override REDIACC_ALLOW_CONFIG_EDIT e il log di audit con hash a catena.

Passi successivi