Passa al contenuto principale Passa alla navigazione Passa al piè di pagina
A tempo limitato: Programma Design Partner. Piano BUSINESS gratuito per sempre.→

Panoramica sull'integrazione degli agenti AI

Come Claude Code, Cursor e Cline gestiscono l'infrastruttura Rediacc tramite rdc: output JSON, introspezione degli agenti e guardrail di sicurezza.

A dirla tutta, rdc è progettato con piena consapevolezza degli agenti. Claude Code, Cursor, Cline: qualsiasi assistente AI che invoca rdc in una subshell ottiene output JSON strutturato, errori leggibili dalla macchina e i guardrail che ti aspetteresti per la gestione autonoma dell’infrastruttura Rediacc. Ecco come funziona l’integrazione.

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

Inseriscilo nel progetto e l’agente avrà il riferimento completo ai comandi, il contesto architetturale e le convenzioni necessarie per lavorare senza dover indovinare.

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

Va detto che la CLI non tratta gli agenti allo stesso modo di un essere umano alla tastiera. Le operazioni sensibili richiedono la prova di una conoscenza previa dello stato corrente (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