Saltar para o conteúdo principal Saltar para a navegação Saltar para o rodapé
Programa de Parceiros de Design: registe-se gratuitamente, plano BUSINESS vitalício→

Visão Geral da Integração com Agentes de IA

Como assistentes de programação com IA, como o Claude Code, o Cursor e o Cline, se integram com a infraestrutura Rediacc para implementação e gestão autónomas.

Os assistentes de programação com IA podem gerir a infraestrutura Rediacc de forma autónoma através do CLI rdc. Este guia aborda as abordagens de integração e como começar.

Por Que Self-Hosted + Agentes de IA

A arquitetura da Rediacc é naturalmente compatível com agentes:

  • CLI-first: Todas as operações são comandos rdc, sem necessidade de interface gráfica
  • Baseado em SSH: O protocolo que os agentes conhecem melhor a partir dos dados de treino
  • Saída JSON: Todos os comandos suportam --output json com um envelope consistente
  • Isolamento Docker: Cada repositório tem o seu próprio daemon e namespace de rede
  • Scriptável: --yes ignora confirmações, --dry-run pré-visualiza operações destrutivas

Abordagens de Integração

1. Template AGENTS.md / CLAUDE.md

A forma mais rápida de começar. Copie o nosso template AGENTS.md para a raiz do seu projeto:

  • CLAUDE.md para o Claude Code
  • .cursorrules para o Cursor
  • .windsurfrules para o Windsurf

Isto fornece ao agente contexto completo sobre os comandos disponíveis, a arquitetura e as convenções.

2. Pipeline de Saída JSON

Quando os agentes chamam rdc num subshell, a saída muda automaticamente para JSON (deteção de não-TTY). Todas as respostas JSON usam um envelope consistente:

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

As respostas de erro incluem os campos 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. Descoberta de Capacidades do Agente

O subcomando rdc agent fornece introspeção estruturada:

# Listar todos os comandos com argumentos e opções
rdc agent capabilities

# Mostrar o esquema detalhado de um comando específico
rdc agent schema --command "machine query"

# Executar um comando com stdin JSON
echo '{"name": "prod-1"}' | rdc agent exec "machine query"
Referência da CLI: rdc agent capabilities · rdc agent schema

Flags Principais para Agentes

FlagFinalidade
--output json / -o jsonSaída JSON legível por máquina
--yes / -yIgnorar confirmações interativas
--quiet / -qSuprimir saída informativa para stderr
--fields name,statusLimitar a saída a campos específicos
--dry-runPré-visualizar operações destrutivas sem as executar

Segurança e Controlos

O CLI trata os agentes de IA de forma diferente dos utilizadores humanos. As operações sensíveis requerem prova de conhecimento prévio (a flag --current), os fluxos de editor interativo são recusados por omissão, e cada recusa é registada em auditoria. A referência Segurança e Controlos para Agentes de IA cobre a tabela completa de firewall, o modelo de knowledge-gate, o scope-override REDIACC_ALLOW_CONFIG_EDIT, e o registo de auditoria com cadeia de hashes.

Próximos Passos