> **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: 1. Acesse o painel da OpenAI. 2. Faça login com a conta corporativa da empresa. 3. Acesse a área de chaves de API. 4. Clique em **Create new secret key**. 5. 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: 1. Acesse **Configurações → Sara**. 2. Vá até a seção **OpenAI API Key** ou **Chave da API OpenAI**. 3. Clique em **Remover chave**. 4. 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: 1. Gere uma nova chave no painel da OpenAI. 2. Acesse **Configurações → Sara** no MEDSAC. 3. Cole a nova chave no campo indicado. 4. Clique em **Salvar chave**. 5. 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 é: 1. Chave configurada na própria conta. 2. Configuração antiga ou legado, se existir. 3. 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.