Segredos e variáveis de ambiente sem colar chaves no chat

A maioria dos apps reais precisa de pelo menos um segredo: a chave de um provedor de pagamentos, a chave de um serviço de e-mail, uma chave para uma API de IA. No Mythex você não cola essas chaves em um prompt. Quando o agente precisa de uma delas, ele mostra um cartão de pedido de segredo no chat, você digita o valor dentro do cartão, e o valor é guardado como segredo do projeto, que o seu app consegue ler. Assim, a chave não acaba na conversa.

O que faz

Cada projeto do Mythex pode guardar variáveis de ambiente: valores com nome, como STRIPE_SECRET_KEY, que o seu app lê quando roda, em vez de ter esses valores escritos no código. Segredos são variáveis de ambiente cujos valores precisam ficar privados.

Os mesmos valores ficam disponíveis em dois lugares:

• O sandbox, onde o agente constrói e roda o seu app enquanto você trabalha.
• Suas publicações, onde os visitantes usam o app.

Há três formas de adicioná-los:

1. O cartão de pedido de segredo, que o agente mostra no chat quando precisa de uma chave para terminar algo.
2. Configurações do projeto → Segredos, onde você pode adicionar ou editar valores a qualquer momento.
3. /secrets no chat, para adicionar ou atualizar segredos quando quiser.

Por que ajuda

A forma mais óbvia de dar uma chave a um agente de IA é colá-la na sua mensagem. Funciona, mas a chave passa a fazer parte do histórico do chat, em texto puro, junto de tudo o que você disse.

O cartão de segredo mantém o valor fora da transcrição. Você o digita nos campos do cartão, e não na caixa de mensagem, e ele é guardado como segredo do projeto. O agente segue em frente com a chave disponível no sandbox.

Manter as chaves nas configurações do projeto, e não no código, traz outras vantagens:

• As chaves ficam fora do controle de versão. Seu código se refere a uma chave pelo nome; o valor fica nas configurações do projeto.
• O agente e o seu app em execução veem a mesma configuração. Não existe uma cópia que fique desatualizada.
• Você pode trocar uma chave sem reescrever o código. Altere o valor nas configurações; o código continua lendo pelo nome.

Se variáveis de ambiente são novidade para você, nosso guia sobre o que são variáveis de ambiente e segredos explica a ideia do zero.

Como usar o cartão de segredo

1. Peça a funcionalidade, por exemplo: “envie um e-mail de boas-vindas quando alguém se cadastrar”.
2. Quando o agente precisar de uma chave, um cartão de pedido de segredo aparece no chat, listando o valor de que ele precisa.
3. Digite o valor nos campos do cartão, e não na caixa de mensagem.
4. Confirme. O valor é guardado como segredo do projeto.
5. O agente continua, com a chave disponível no sandbox.

Como adicionar segredos você mesmo

1. Abra as configurações do projeto e depois Segredos.
2. Adicione chaves como STRIPE_SECRET_KEY, OPENAI_API_KEY ou as credenciais do seu próprio serviço.
3. Peça ao agente para ler essas chaves do jeito padrão do seu framework, por exemplo a partir de process.env em um app Node.
4. Publique de novo se um app publicado precisar dos novos valores.

Você também pode digitar /secrets no chat para adicionar ou atualizar segredos por ali.

Como alterar um segredo em um app publicado

Um app publicado recebe os segredos no momento da publicação. Depois de adicionar ou alterar um, publique de novo para que a versão no ar receba o novo valor. Até lá, os visitantes continuam usando o app com a configuração antiga.

Dicas de segurança

• Nunca coloque segredos no repositório. Mantenha-os nas configurações do projeto.
• Prefira chaves exclusivas do servidor para operações privilegiadas. Uma chave que pode cobrar cartões ou enviar e-mails deve ficar em código que roda no servidor, nunca em algo que o navegador do visitante baixa.
• Se uma chave já apareceu no histórico do chat, troque-a. Crie uma nova chave no provedor, revogue a antiga e atualize o valor nas configurações do projeto. Considere exposta qualquer chave colada em um chat.

Limites

• O cartão só ajuda se você usá-lo. Se mesmo assim você colar uma chave na caixa de mensagem, ela fica na transcrição. Revogue-a no provedor e atualize o valor guardado.
• Apps publicados precisam ser publicados de novo para pegar segredos novos ou alterados.
• Guardar uma chave com segurança não torna todo uso dela seguro. Onde a chave é usada continua importando: mantenha as chaves privilegiadas do lado do servidor do seu app.

Para mais sobre como deixar um app seguro antes de compartilhá-lo, veja nossa lista de verificação de segurança para apps criados com IA.

A documentação tem os detalhes: Variáveis de ambiente e segredos e Segredos no chat.