Segredos e Variáveis de Ambiente Sem Colar Chaves no Chat

A maioria das apps reais precisa de pelo menos um segredo: a chave de um fornecedor de pagamentos, a chave de um serviço de email, a chave de uma API de IA. No Mythex não colas essas chaves num prompt. Quando o agente precisa de uma delas, mostra um cartão de pedido de segredo no chat, escreves o valor no cartão e fica guardado como segredo do projeto que a tua app consegue ler, sem que a chave acabe na conversa.

O que faz

Cada projeto do Mythex pode guardar variáveis de ambiente: valores com nome, como STRIPE_SECRET_KEY, que a tua app lê quando corre, em vez de os ter escritos no código. Os segredos são variáveis de ambiente cujos valores têm de se manter privados.

Os mesmos valores ficam disponíveis em dois sítios:

• A sandbox, onde o agente constrói e corre a tua app enquanto trabalhas.
• As tuas publicações, que os visitantes usam.

Há três formas de os adicionar:

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

Porque ajuda

A forma óbvia de dar uma chave a um agente de IA é colá-la na tua mensagem. Funciona, mas a chave fica então a fazer parte do histórico do chat, em texto simples, ao lado de tudo o que disseste.

O cartão de segredo mantém o valor fora da transcrição. Introduzes o valor nos campos do cartão, não na caixa de mensagens, e fica guardado como segredo do projeto. O agente continua com a chave disponível na sandbox.

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

• As chaves ficam fora do controlo de versões. O teu código refere uma chave pelo nome; o valor fica nas definições do projeto.
• O agente e a tua app em execução veem a mesma configuração. Não há cópias que fiquem desatualizadas.
• Podes renovar uma chave sem reescrever código. Mudas o valor nas definições; o código continua a lê-la pelo nome.

Se as variáveis de ambiente forem novidade para ti, o nosso guia sobre o que são variáveis de ambiente e segredos explica a ideia desde o início.

Como usar o cartão de segredo

1. Pede a funcionalidade, por exemplo, "envia um email de boas-vindas quando alguém se regista".
2. Quando o agente precisar de uma chave, aparece um cartão de pedido de segredo no chat, a listar o valor de que precisa.
3. Introduz o valor nos campos do cartão, não na caixa de mensagens.
4. Confirma. O valor fica guardado como segredo do projeto.
5. O agente continua, com a chave disponível na sandbox.

Como adicionar segredos tu próprio

1. Abre as definições do projeto e depois Segredos.
2. Adiciona chaves como STRIPE_SECRET_KEY, OPENAI_API_KEY ou as credenciais do teu próprio serviço.
3. Pede ao agente que as leia da forma padrão da tua framework, por exemplo a partir de process.env numa app Node.
4. Publica de novo se uma app publicada precisar dos novos valores.

Também podes escrever /secrets no chat para os adicionar ou atualizar por lá.

Alterar um segredo numa app publicada

Uma app publicada recebe os segredos quando é publicada. Depois de adicionares ou alterares um, publica de novo para que a publicação em produção receba o novo valor. Até lá, os visitantes continuam a usar a app com a configuração antiga.

Dicas de segurança

• Nunca envies segredos para o repositório. Guarda-os nas definições do projeto.
• Prefere chaves só de servidor para operações privilegiadas. Uma chave que possa cobrar cartões ou enviar emails pertence a código que corre no servidor, e não a algo que o browser de um visitante descarregue.
• Se uma chave alguma vez aparecer no histórico do chat, renova-a. Cria uma nova chave no fornecedor, revoga a antiga e atualiza o valor nas definições do projeto. Considera exposta qualquer chave que tenha sido colada num chat.

Limites

• O cartão só ajuda se o usares. Se colares uma chave na caixa de mensagens de qualquer forma, ela fica na transcrição. Renova-a no fornecedor e atualiza o valor guardado.
• As apps publicadas precisam de nova publicação para receber segredos novos ou alterados.
• Guardar uma chave com segurança não torna seguro todo o uso que dela se faça. Onde a chave é usada continua a importar: mantém as chaves privilegiadas do lado do servidor da tua app.

Para mais sobre como manter uma app segura antes de a partilhar, vê a nossa lista de verificação de segurança para apps criadas com IA.

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