Segredos

Alguns projetos usam um serviço de fora, como o envio de e-mail ou uma ferramenta de IA. Esse serviço entrega uma chave de API, e o projeto guarda essa chave em Segredos, fora do código e fora do chat.

O agente pede o valor

Quando o seu pedido precisa de uma chave, o agente mostra um card no chat: "O app precisa de uma variável de ambiente. Informe o valor e eu salvo."

1. Confira o nome. O agente já preencheu a Chave, como RESEND_API_KEY.
2. Cole o valor. Copie a chave na conta do serviço e cole no campo Valor.
3. Clique em Salvar. O card mostra "Salva", e o agente continua o trabalho.

O agente nunca vê o valor, porque o card salva direto no projeto. Se você ainda não tem a chave, clique em Agora não. Não cole a chave no chat: no chat, o agente lê o que você escreve.

Exemplo de pedido:

Alguns segredos o agente cria sozinho, e eles aparecem na lista do painel.

Segredo ou público

No card e no painel, o campo Tipo decide quem vê o valor.

• Segredo. Só o app usa o valor, e ninguém o lê de volta, nem você nem o agente. Use para senhas e chaves de API.
• Público. Qualquer pessoa que abre o app consegue ver o valor. Use para endereços e IDs, nunca para informação sensível.

O agente propõe o tipo, e você pode trocar antes de salvar.

Preview e produção

O campo Ambiente decide onde o valor vale: Preview, Produção ou Todos, que vale nos dois.

• No preview. O projeto passa a usar o valor novo em alguns segundos, sem você fazer nada.
• No app no ar. O valor novo entra quando você publica de novo.

Uma chave de teste no Preview e a chave real em Produção deixam você testar sem mexer no que está vendendo.

Adicionar, trocar e excluir

Os segredos do projeto ficam no painel Segredos. Cada linha mostra a chave, o ambiente e o tipo. Só o Dono e quem é Editor adicionam e excluem. Quem é Leitor só vê a lista.

1. Abra o painel Segredos. Clique em Adicionar segredo.
2. Preencha o formulário. Escolha o Tipo, escreva a Chave e o Valor e escolha o Ambiente.
3. Clique em Salvar.

Um segredo não se edita, e o valor substituído não volta. Para trocar o valor, adicione a mesma chave no mesmo ambiente, e o valor novo substitui o antigo.

Excluir não tem como desfazer. Para tirar um segredo, clique em Excluir na linha e confirme. Uma linha marcada Gerenciada pela Conexão vem de um serviço ligado ao projeto e não sai por aqui.