Question 1

O AI Emaily armazena minha chave em texto simples em algum lugar?

Accepted Answer

Nunca. No momento em que você envia a chave, ela é criptografada com envelope com sua DEK por usuário antes de ser gravada no banco de dados. Apenas o blob criptografado é persistido. O texto simples aparece apenas na memória do worker isolado durante a duração de uma única chamada de API.

Question 2

O que acontece se minha chave BYOK ficar sem cota?

Accepted Answer

O AI Emaily exibe a mensagem de erro do provedor na interface e pausa as operações de IA para aquela caixa de entrada. O acesso manual ao e-mail — ler, pesquisar, redigir sem IA — continua sem interrupção. Você pode recarregar a cota com seu provedor ou voltar ao pool compartilhado do AI Emaily em Configurações.

Question 3

Posso usar BYOK com o Autopilot?

Accepted Answer

Sim. O Autopilot usa qualquer fonte de chave configurada para a caixa de entrada no momento em que cada ação é executada. Se você mudar de BYOK para o pool compartilhado no meio do dia, as ações de Autopilot subsequentes usam o pool compartilhado; as ações concluídas anteriormente não são afetadas e permanecem no log de auditoria.

Question 4

O que é BYOK no AI Emaily?

Accepted Answer

BYOK — traga sua própria chave — permite conectar sua própria chave de API da Anthropic, OpenAI ou Google AI em qualquer plano pago. As operações de IA passam a ser executadas com os créditos do seu próprio provedor sem limites de uso do AI Emaily, em vez de usar os créditos incluídos no seu plano. Sua chave é criptografada com envelope no momento em que você a cola, descriptografada apenas dentro de um worker isolado durante a duração de uma única chamada e nunca registrada nem exposta ao código da aplicação.

Question 5

Quais provedores e modelos de IA o BYOK suporta?

Accepted Answer

O BYOK atualmente suporta Anthropic (Claude 3.5 Sonnet, Claude 3 Haiku, Claude 3 Opus), OpenAI (GPT-4o, GPT-4o mini, GPT-4 Turbo) e Google AI (Gemini 1.5 Pro, Gemini 1.5 Flash). Você adiciona uma chave por provedor em Configurações → IA → Chaves de modelo, e pode manter uma chave salva mas alternar entre "Minha chave" e o pool compartilhado do AI Emaily por provedor sem excluí-la.

Question 6

Por que eu usaria BYOK em vez dos créditos incluídos?

Accepted Answer

Duas razões. Primeiro, a capacidade: usuários intensivos com caixas de entrada grandes ou alto volume de Autopilot podem pagar diretamente ao provedor e ignorar completamente os limites de uso do AI Emaily. Segundo, os termos: sua chave de API opera sob o acordo de processamento de dados da sua própria organização com o provedor, portanto, se você já tem um DPA de zero retenção ou empresarial com a Anthropic ou OpenAI, o BYOK permite herdar esses termos automaticamente em vez de depender dos nossos.

Question 7

Minha chave BYOK é armazenada ou registrada em texto simples em algum momento?

Accepted Answer

Nunca. No instante em que você envia uma chave, ela é criptografada com envelope com sua DEK por usuário, e apenas o blob criptografado é gravado no banco de dados. O código da aplicação, relatórios de erros e pipelines de análise nunca veem o texto simples. A descriptografia acontece apenas dentro de uma Appwrite Function isolada cujo único egresso de saída é o endpoint de API do provedor do modelo, e os bytes descriptografados existem em memória apenas durante o tempo de vida de uma única solicitação HTTP.

Question 8

Como rotaciono ou removo minha chave BYOK?

Accepted Answer

Para rotacionar, cole uma nova chave em Configurações → IA → Chaves de modelo a qualquer momento — o texto cifrado antigo é sobrescrito imediatamente, sem etapa de migração. Para remover uma chave completamente, clique em "Remover" e o texto cifrado é excluído do banco de dados em segundos. Você também pode usar "Testar chave" para enviar uma sonda mínima de token único e confirmar que uma nova chave é válida e tem cota antes de depender dela.

Question 9

Posso usar uma chave de IA diferente por caixa de entrada?

Accepted Answer

Sim. Se você gerencia várias caixas de entrada sob uma conta do AI Emaily, pode atribuir uma chave BYOK diferente — ou o pool compartilhado — a cada caixa de entrada conectada. Isso é útil quando, por exemplo, uma conta pessoal opera no nível compartilhado gratuito enquanto uma conta de trabalho usa uma chave corporativa da Anthropic. Cada ação de IA é marcada no log de auditoria com o provedor e os últimos quatro caracteres da chave usada, para que o uso seja fácil de reconciliar.

Question 10

Usar o BYOK muda como meus dados são tratados?

Accepted Answer

Muda com quem você contrata, não o nosso tratamento. Com o BYOK, o worker isolado chama seu provedor na sua conta, portanto a inferência é regida pelo seu acordo com eles — o AI Emaily ainda nunca treina com seus e-mails nem os retém. Vemos apenas a resposta em texto simples dentro desse worker em sandbox, nunca persistida. A chave descriptografada e a resposta são mantidas em memória para uma única solicitação e nunca são gravadas em disco, cache ou log.

Traga sua própria chave (BYOK)

Por que BYOK?

Como habilitar o BYOK

Provedores e modelos suportados

Isolamento e auditoria

Frequently asked

Provedor	Modelos disponíveis via BYOK	Formato da chave
Anthropic	Claude 3.5 Sonnet, Claude 3 Haiku, Claude 3 Opus	sk-ant-…
OpenAI	GPT-4o, GPT-4o mini, GPT-4 Turbo	sk-…
Google AI	Gemini 1.5 Pro, Gemini 1.5 Flash	AIza…