Informativo: A Sara é uma IA de apoio e pode cometer erros. Revise e valide as respostas antes de usar. Ao utilizá-la, você concorda em acompanhar e melhorar suas configurações.
A Sara utiliza modelos de inteligência artificial da OpenAI para gerar respostas, sugestões, resumos e outras ações dentro do MEDSAC.
Para que a Sara funcione corretamente, é necessário configurar uma chave OpenAI na conta. Essa chave permite que o MEDSAC se comunique com os modelos de IA usados pela assistente.
Este artigo explica por que configurar uma chave própria, onde obtê-la, como cadastrá-la no MEDSAC, como ela é protegida e como removê-la quando necessário.
Por que configurar uma chave OpenAI própria
É recomendado que cada clínica, laboratório ou empresa utilize sua própria chave OpenAI.
Isso oferece mais controle sobre o uso da inteligência artificial e facilita a gestão dos custos e da segurança.
Os principais benefícios são:
1. Mais controle sobre o uso
Ao usar uma chave própria, a empresa consegue acompanhar diretamente o consumo no painel da OpenAI.
Isso facilita o controle de uso, custos, limites e auditoria.
2. Faturamento direto
Com a chave própria, os custos de uso dos modelos de IA são vinculados à conta OpenAI da própria empresa.
Assim, a empresa tem mais previsibilidade sobre o consumo e pode acompanhar os valores diretamente na plataforma da OpenAI.
3. Segurança e gestão da chave
A empresa pode criar, substituir, limitar ou revogar a chave quando necessário.
Isso é importante em casos de troca de responsável técnico, revisão de segurança ou alteração da conta OpenAI utilizada.
4. Organização por conta
A chave OpenAI é configurada por conta no MEDSAC.
Isso significa que todos os assistentes da Sara dentro daquela conta usam a mesma chave configurada.
Onde obter a chave OpenAI
Para gerar uma chave OpenAI:
-
Acesse o painel da OpenAI.
-
Faça login com a conta corporativa da empresa.
-
Acesse a área de chaves de API.
-
Clique em Create new secret key.
-
Dê um nome descritivo para a chave.
Exemplo de nome:
MEDSAC produção
Depois de criar, copie a chave gerada.
A chave geralmente começa com:
sk-
ou formatos semelhantes, conforme o tipo de conta e projeto utilizado.
Atenção: a OpenAI exibe a chave completa apenas no momento da criação. Depois que a janela for fechada, não será possível visualizar a chave novamente.
Guarde a chave com segurança.
Como configurar a chave no MEDSAC
1. Acesse as configurações da Sara
No menu lateral do MEDSAC, acesse:
Configurações → Sara
Em seguida, procure pela seção de configuração da chave OpenAI.
Essa seção pode aparecer com nomes como:
OpenAI API Key
ou
Chave da API OpenAI
2. Cole a chave no campo indicado
No campo de chave da API OpenAI, cole a chave gerada no painel da OpenAI.
O campo pode ocultar os caracteres digitados por segurança.
Isso significa que a chave pode aparecer como pontos ou asteriscos durante o preenchimento.
3. Salve a chave
Após colar a chave, clique em:
Salvar chave
O MEDSAC validará a informação e armazenará a chave de forma protegida.
Depois de salvar, o campo será limpo e a chave passará a aparecer apenas de forma mascarada.
Exemplo:
sk-...abcd
Isso indica que a chave foi cadastrada, mas não será exibida por completo na tela.
Como saber se a chave foi salva corretamente
Após salvar, verifique se a tela mostra uma chave atual mascarada.
Exemplo:
Chave atual: sk-...abcd
Se essa informação aparecer, significa que a chave foi registrada na conta.
Depois disso, a Sara poderá usar essa chave para executar as ações de inteligência artificial, desde que os demais recursos também estejam configurados.
Segurança da chave
Depois que a chave é salva, o MEDSAC não exibe mais o valor completo.
A chave fica mascarada para evitar exposição indevida.
Isso protege contra situações como:
-
alguém visualizar a tela por engano;
-
outro administrador copiar a chave completa;
-
exposição acidental durante suporte ou treinamento;
-
prints de tela com dados sensíveis.
Mesmo usuários administradores conseguem ver apenas que existe uma chave configurada, mas não conseguem visualizar o valor completo.
Como remover a chave OpenAI
Para remover a chave:
-
Acesse Configurações → Sara.
-
Vá até a seção OpenAI API Key ou Chave da API OpenAI.
-
Clique em Remover chave.
-
Confirme a remoção.
Depois de removida, a conta deixará de usar aquela chave.
Se não houver outra chave disponível para uso, a Sara poderá ficar indisponível para gerar respostas, sugestões e demais ações de IA.
Como trocar ou rotacionar a chave
Em alguns casos, pode ser necessário substituir a chave OpenAI.
Isso pode acontecer quando:
-
a chave antiga foi revogada;
-
houve troca da conta OpenAI;
-
a empresa deseja melhorar a segurança;
-
o responsável técnico mudou;
-
a chave foi exposta por engano;
-
é necessário separar ambientes ou projetos.
Para trocar a chave:
-
Gere uma nova chave no painel da OpenAI.
-
Acesse Configurações → Sara no MEDSAC.
-
Cole a nova chave no campo indicado.
-
Clique em Salvar chave.
-
Se necessário, revogue a chave antiga no painel da OpenAI.
A troca passa a valer para as próximas chamadas realizadas pela Sara.
Ordem de uso da chave
Quando a Sara precisa usar a OpenAI, o sistema verifica qual chave está disponível.
A prioridade normalmente é:
-
Chave configurada na própria conta.
-
Configuração antiga ou legado, se existir.
-
Chave global da plataforma, quando disponível.
A primeira chave válida encontrada será usada.
Se nenhuma chave estiver disponível, a Sara poderá apresentar erro de autenticação ou não conseguir executar ações de IA.
Casos comuns
Salvei a chave, mas a Sara continua dando erro
Se a chave foi salva, mas a Sara ainda não funciona, verifique:
-
se a Sara está habilitada em Configurações → Integrações;
-
se a chave OpenAI está ativa;
-
se a chave não foi revogada no painel da OpenAI;
-
se há saldo ou limite disponível na conta OpenAI;
-
se existe pelo menos um assistente configurado;
-
se a caixa de entrada está conectada ao assistente;
-
se os recursos de IA estão habilitados.
A chave é apenas uma parte da configuração. Para a Sara responder, os demais itens também precisam estar configurados corretamente.
A chave foi salva, mas não aparece completa
Esse é o comportamento esperado.
Por segurança, o MEDSAC nunca exibe a chave completa depois que ela é salva.
Você verá apenas uma versão mascarada, como:
sk-...abcd
Preciso trocar a chave
Para trocar a chave, basta gerar uma nova no painel da OpenAI e salvá-la novamente no MEDSAC.
A nova chave substituirá a anterior.
Depois da troca, recomenda-se revogar a chave antiga no painel da OpenAI, caso ela não seja mais utilizada.
A clínica usa Azure OpenAI ou outro provedor compatível
Em alguns ambientes, é possível usar provedores compatíveis com a API da OpenAI.
Nesses casos, além da chave, pode ser necessário configurar um endpoint específico ou parâmetros adicionais.
Essa configuração pode depender do time técnico ou do suporte da plataforma.
Perguntas frequentes
A chave fica visível para outros administradores?
Não completamente.
Outros administradores podem ver que existe uma chave configurada, mas o valor completo não é exibido.
A chave aparece apenas mascarada.
Atendentes conseguem alterar a chave?
Não.
A configuração da chave OpenAI é restrita a usuários com permissão de Administrador.
Atendentes não devem ter acesso a essa configuração.
Posso configurar uma chave diferente por assistente?
Não.
A chave é configurada por conta.
Todos os assistentes da Sara dentro da mesma conta usam a mesma chave OpenAI configurada.
Se eu remover a chave, perco meus assistentes ou documentos?
Não.
Remover a chave não apaga assistentes, documentos, FAQs, cenários, diretrizes ou proteções.
A remoção afeta apenas a capacidade da Sara de executar ações que dependem da OpenAI.
Habilitar a chave consome créditos automaticamente?
Não.
Apenas cadastrar ou salvar a chave não gera consumo.
O consumo acontece quando a Sara executa ações de inteligência artificial, como:
-
gerar resposta;
-
sugerir mensagem;
-
resumir conversa;
-
processar áudio;
-
classificar atendimento;
-
consultar base de conhecimento;
-
executar ações automatizadas com IA.
Resumo final
A chave OpenAI é necessária para que a Sara consiga executar recursos de inteligência artificial no MEDSAC.
Ao configurar uma chave própria, a empresa ganha mais controle sobre consumo, segurança e faturamento.
Depois de salvar a chave, ela ficará protegida e será exibida apenas de forma mascarada.
Para a Sara funcionar corretamente, além da chave OpenAI, também é necessário configurar os assistentes, os recursos ativos e as caixas de entrada conectadas.