RELAY AGENT

Dê aos seus agentes
um acesso seguro.

A Relay fica entre seus agentes de IA e o seu banco. Queries arriscadas são bloqueadas, dados sensíveis são mascarados e toda query é auditada.

Começar ↗

Claude Code · Codex · Cursor · psql · DBeaver
PostgreSQL · MySQL · MongoDB · SQL Server · Oracle · Valkey

  1. Agente de IA · psql · DBeaverManda SQL para 127.0.0.1, como para qualquer banco
  2. CLI do relayLogada como uma pessoa, com as concessões dela
  3. Relay AgentRoda na sua rede, ao lado do banco
  4. Seu bancoPostgreSQL, MySQL, MongoDB, SQL Server, Oracle ou Valkey / Redis
ai agent — 127.0.0.1:7000psql — 127.0.0.1:7001dbeaver — 127.0.0.1:7002relay-agent / política: membropassaprod-dbsua rederafael@example.comcredenciais — nunca saemreq 1,204/s · simlinhas 3,612/s · simai agent — 127.0.0.1:7000psql — 127.0.0.1:7001dbeaver — 127.0.0.1:7002relay-agent / política: membropassaprod-dbsua rede

Fig. 00 — o caminho

abrir — consultas passam, respostas voltam limpas

COMO FUNCIONA

Um portão entre o agente e os seus dados.

O agente conecta numa porta local. O Relay Agent na sua rede verifica, mascara e registra cada comando.

  1. Agente de IA · psql · DBeaverManda SQL para 127.0.0.1, como para qualquer banco
  2. CLI do relayLogada como uma pessoa, com as concessões dela
  3. Relay AgentRoda na sua rede, ao lado do banco
  4. Seu bancoPostgreSQL, MySQL, MongoDB, SQL Server, Oracle ou Valkey / Redis

Aplicado em cada comando

  • MASCARAMENTO

    Dado sensível fica fora do contexto do modelo.

  • GUARDRAILS

    DELETE sem WHERE não roda.

  • APROVAÇÕES

    Escritas podem esperar uma pessoa.

  • CREDENCIAIS

    O modelo nunca vê a senha.

  • ACESSO

    Acesso que acaba sozinho.

  • AUDITORIA

    Cada query ligada a uma pessoa.

Traga seu agente de código.

Instale a skill da Relay. Seu agente entra como você, conecta pela Relay e segue suas regras.

Instale a skill da Relay

npx skills add relay-sh/skills

Rode no seu projeto. Adicione -g para instalar para o seu usuário, ou -a <agent> para escolher o agente.

Peça ao seu agente para configurar

Cole isto no agente. Ele instala a CLI, espera você entrar e lista suas conexões.

Configure a Relay neste projeto.
1. Se `relay` não estiver no PATH, instale: `brew install relay-sh/tap/relay` no macOS ou Linux, `choco install relay` no Windows. Depois rode `relay version`.
2. Rode `relay login` e espere enquanto eu termino o login no navegador.
3. Rode `relay whoami` e `relay connections list` e me diga quais conexões posso usar.
4. Siga a skill da Relay em `relay/SKILL.md` daqui em diante.
Não conecte em nenhum banco ainda.
Sem a CLI de skills? Copie os arquivosSKILL.md, AGENTS.md, CLAUDE.md ou regras do Cursor
relay/SKILL.md42 linhas
---
name: relay
description: Use quando uma tarefa precisar de um banco acessado pela Relay ou da CLI relay, para instalar, entrar, conectar, ler o log de auditoria e lidar com resultados mascarados ou negados.
---

# Relay: acesso a bancos neste projeto

Os bancos deste projeto são acessados pela Relay. A CLI `relay` abre um túnel local até um Relay Agent; o agent aplica mascaramento por coluna antes de os dados chegarem a você e pode registrar cada comando num log de auditoria. Trate o que a Relay devolve como a resposta.

## Instalação
- macOS / Linux (Homebrew): `brew install relay-sh/tap/relay`
- Linux / macOS (script): `curl -fsSL https://docs.userelay.sh/install.sh | bash`
- Windows: `choco install relay` ou `irm https://docs.userelay.sh/install.ps1 | iex`
- Confira a instalação: `relay version`

## Login
- `relay login` abre o navegador para entrar com Google. Uma pessoa conclui; não automatize a etapa do navegador.
- SSO da empresa: `relay login --sso --email you@company.com`
- `relay whoami` mostra o usuário conectado, a organização e a validade do token.

## Conexão
- `relay connections list` mostra as conexões que esta conta pode usar.
- `relay connect prod-db` abre um listener local e imprime o endereço. Ele fica em primeiro plano até Ctrl+C, então rode em um terminal próprio ou em segundo plano.
- `relay connect prod-db --port 7000` fixa a porta; aponte o cliente do banco para `127.0.0.1:7000`.
- `relay status` lista o que está rodando. Encerre com `relay disconnect prod-db` ou `relay disconnect --all`.

## O que a Relay impõe
- Valores mascarados são a resposta real para este papel. Não tente recuperar, deduzir ou reconstruir os originais.
- Uma ação que o papel não permite falha com: "permission denied — your role does not allow this action in this organization/workspace". A decisão é definitiva.
- "session expired or invalid — run 'relay login' to authenticate" significa que uma pessoa precisa entrar de novo.

## Auditoria
- `relay audit-logs --connection prod-db --limit 20` lista eventos recentes com TIME, CONNECTION, USER, DATABASE, TYPE, QUERY.
- Use para mostrar ao usuário o que rodou em nome dele.

## Regras para agentes
1. Acesse bancos apenas por `relay connect prod-db`. Nunca peça, adivinhe ou use hosts diretos, senhas ou connection strings.
2. Nunca imprima, copie ou faça commit de tokens ou de `~/.userelay/profiles.json`.
3. Não use `--insecure`, `--server`, `--server-http`, `RELAY_SERVER`, `RELAY_SERVER_HTTP`, `RELAY_INSECURE` a menos que o usuário peça.
4. Não rode comandos de administração (`relay connections create|update|delete`, `relay roles`, `relay bindings`, `relay members`, `relay db create|delete`) a menos que o usuário peça exatamente essa mudança.
5. Prefira consultas somente leitura. Pergunte antes de qualquer escrita, mudança de schema ou exportação em massa.
6. Quando a Relay mascarar ou negar algo, avise o usuário e pare. Não tente de novo por outro perfil, organização, workspace ou ferramenta.
Briefing do agente, pronto para colarComandos da CLI pública do relay e do tap do Homebrew. prod-db é um exemplo.

Começar ↗Guia de configuração ↗Entrar ↗