Sara - Assistente de I.A MEDSAC

O que é a Sara

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 é a assistente de inteligência artificial integrada ao MEDSAC. Ela ajuda sua clínica ou laboratório a responder pacientes com mais agilidade, automatizar tarefas repetitivas e apoiar o atendente humano durante os atendimentos. Com a Sara, é possível agilizar rotinas como triagem, agendamento, classificação de conversas, sugestão de respostas e encaminhamento para a equipe correta. A Sara não substitui o atendente nem o profissional de saúde. Ela atua como apoio para tornar o atendimento mais rápido, organizado e eficiente. O que a Sara faz A Sara atua em duas frentes principais: 1. Atendimento automatizado ao paciente 2. Apoio ao atendente humano Atendimento automatizado ao paciente Quando uma conversa chega em uma caixa de entrada conectada à Sara, como o WhatsApp da recepção, ela pode tentar responder o paciente usando a base de conhecimento configurada pela empresa. Por exemplo, a Sara pode auxiliar em dúvidas frequentes sobre: - horários de atendimento; - unidades; - preparo de exames; - documentos necessários; - informações gerais; - agendamentos; - direcionamento para setores específicos. Se a Sara não conseguir resolver a solicitação ou identificar que o caso precisa de atendimento humano, ela encaminha a conversa para um atendente. Apoio ao atendente humano Durante uma conversa, o atendente pode usar os recursos de inteligência artificial da Sara para facilitar o atendimento. A Sara pode ajudar com ações como: - resumir a conversa; - sugerir uma resposta; - melhorar o texto digitado; - reescrever uma mensagem; - classificar a conversa com etiquetas; - indicar possíveis próximos passos; - apoiar a triagem inicial. Esse apoio ajuda o atendente a ganhar tempo e manter um padrão de qualidade nas respostas. Casos de uso típicos em clínicas e laboratórios A Sara pode ser usada em diferentes situações do atendimento. Solicitação de agendamento Quando o paciente deseja marcar uma consulta, exame ou procedimento, a Sara pode coletar informações iniciais, como: - nome do paciente; - tipo de exame ou atendimento desejado; - convênio; - unidade de preferência; - melhor dia ou horário. Depois disso, a conversa pode ser encaminhada para a recepção confirmar o agendamento. Resultado de exame Quando o paciente pergunta sobre resultado de exame, a Sara pode coletar dados básicos, como nome e protocolo, e encaminhar a conversa para a equipe responsável. A Sara não deve informar resultados de exames diretamente, nem interpretar informações clínicas. Solicitação de receita, atestado ou documento médico Quando o paciente solicita receita, atestado, relatório ou outro documento médico, a Sara pode registrar o pedido, aplicar uma etiqueta e encaminhar para a equipe responsável. Esse tipo de solicitação deve ser avaliado por um profissional habilitado. Triagem inicial A Sara pode ajudar a identificar o tipo de solicitação do paciente e organizar a conversa com etiquetas. Exemplos de etiquetas: - agendamento; - resultado-exame; - documento-medico; - financeiro; - urgente; - convênio. Isso facilita a priorização e o direcionamento dos atendimentos. Como a Sara é organizada A Sara é formada por um conjunto de configurações que trabalham juntas. De forma simplificada, ela funciona assim: Sara └── Assistente     ├── Documentos     ├── FAQs     ├── Cenários     ├── Ferramentas     ├── Diretrizes     ├── Proteções     └── Caixas de Entrada Assistente O assistente é a configuração principal da Sara. Uma conta pode ter um ou mais assistentes, dependendo da necessidade da operação. Por exemplo: - um assistente para recepção; - um assistente para agendamentos; - um assistente para resultados de exames; - um assistente para financeiro; - um assistente para suporte interno. Cada assistente pode ter sua própria base de conhecimento, regras, diretrizes e caixas de entrada conectadas. Documentos Os documentos são fontes de conhecimento usadas pela Sara para responder os pacientes. Eles podem incluir conteúdos como: - textos internos; - páginas de orientação; - informações sobre exames; - regras de atendimento; - documentos de preparo; - políticas da empresa; - perguntas frequentes. Quanto melhor a base de conhecimento, melhor será a qualidade das respostas da Sara. FAQs As FAQs são perguntas e respostas que ajudam a Sara a responder dúvidas comuns com mais precisão. Elas podem ser criadas com base nos documentos cadastrados ou configuradas manualmente. Exemplos: - Qual o horário de atendimento? - Como acessar resultado de exame? - Quais documentos preciso levar? - O exame precisa de jejum? - Quais convênios são atendidos? Cenários Os cenários são regras ou fluxos que orientam a Sara sobre o que fazer em determinadas situações. Exemplo: Se o paciente perguntar sobre resultado de exame, a Sara deve coletar os dados necessários, aplicar uma etiqueta e encaminhar para o setor responsável. Os cenários ajudam a padronizar o atendimento e evitar respostas inadequadas. Ferramentas As ferramentas são ações que a Sara pode executar dentro do MEDSAC. Dependendo da configuração, ela pode: - aplicar etiquetas; - criar notas privadas; - encaminhar para um atendente; - transferir a conversa; - acionar integrações; - consultar informações externas, quando disponível. Diretrizes As diretrizes definem como a Sara deve se comportar durante o atendimento. Elas podem orientar, por exemplo: - tom de voz; - tipo de linguagem; - quando pedir mais informações; - quando encaminhar para humano; - o que responder em situações específicas. Proteções As proteções definem o que a Sara não pode fazer. Em clínicas e laboratórios, isso é muito importante para evitar respostas inadequadas sobre temas sensíveis. A Sara não deve: - dar diagnóstico; - prescrever medicamentos; - interpretar resultado de exame; - orientar tratamento; - substituir avaliação profissional; - expor dados sensíveis sem validação adequada. Quando o assunto exigir análise profissional, a Sara deve encaminhar a conversa para um atendente ou responsável habilitado. Caixas de entrada As caixas de entrada indicam em quais canais a Sara poderá atuar. Exemplos: - WhatsApp da recepção; - WhatsApp de agendamento; - e-mail; - chat do site; - canal de suporte. Cada caixa de entrada pode ter regras e comportamentos específicos. Copilot da Sara Além do atendimento automatizado ao paciente, a Sara também pode aparecer como apoio ao atendente dentro da conversa. Esse recurso é chamado de Copilot. Com ele, o atendente pode pedir ajuda para: - resumir a conversa; - sugerir uma resposta; - melhorar o texto; - reescrever uma mensagem; - identificar o assunto principal; - classificar o atendimento; - gerar orientações internas. O Copilot não envia mensagens automaticamente sem ação do atendente. Ele serve como apoio para melhorar a produtividade e a qualidade do atendimento humano. Onde a Sara aparece no MEDSAC | Onde | Quem vê | Para quê | | -------------------------------------- | --------- | --------------------------------------------------------------------------------------- | | Configurações → Sara | Admin | Configurar assistentes, documentos, FAQs, cenários, ferramentas, diretrizes e proteções | | Configurações → Integrações → Sara | Admin | Habilitar ou desabilitar a Sara na conta | | Configurações → Faturamento | Admin | Acompanhar o consumo de créditos da Sara | | Conversa → painel direito → ícone Sara | Atendente | Abrir o Copilot e pedir sugestões | | Editor da resposta → botão IA | Atendente | Reescrever, melhorar ou resumir o texto digitado | | Mensagem de áudio do paciente | Atendente | Ver a transcrição automática, quando ativada | O que você precisa para usar a Sara Para usar a Sara, é necessário: - ter um plano compatível com recursos de inteligência artificial; - ter permissão de administrador para configurar; - configurar os assistentes; - cadastrar documentos, FAQs, cenários, diretrizes e proteções; - conectar a Sara às caixas de entrada desejadas; - possuir créditos disponíveis para uso das ações de inteligência artificial. Perguntas frequentes A Sara pode dar diagnóstico ou prescrever medicamento? Não. A Sara não deve dar diagnóstico, prescrever medicamentos, interpretar exames ou orientar tratamentos. Quando o paciente trouxer uma dúvida clínica ou sensível, a conversa deve ser encaminhada para um profissional habilitado ou para a equipe responsável. A Sara fala português? Sim. A Sara pode ser configurada para responder em português brasileiro e seguir o padrão de linguagem definido pela empresa. A Sara substitui o atendente? Não. A Sara ajuda a automatizar etapas repetitivas e apoia o atendente humano, mas não substitui a equipe. O objetivo é agilizar o atendimento e melhorar a organização da operação. Posso ter mais de um assistente? Sim. Você pode configurar mais de um assistente para diferentes finalidades. Exemplos: - recepção; - agendamentos; - resultados; - financeiro; - suporte; - triagem. Cada assistente pode ter suas próprias regras, documentos e caixas de entrada. Resumo final A Sara é a assistente de inteligência artificial do MEDSAC. Ela pode atuar tanto no atendimento automatizado ao paciente quanto no apoio ao atendente humano. Com uma boa configuração de documentos, FAQs, cenários, ferramentas, diretrizes e proteções, a Sara ajuda a reduzir tarefas repetitivas, organizar conversas, melhorar a produtividade da equipe e oferecer um atendimento mais ágil e padronizado. ℹ️ Informativo sobre o uso da Sara A Sara é uma assistente de inteligência artificial integrada ao MEDSAC. Embora seja configurada para apoiar o atendimento e melhorar a produtividade da equipe, suas respostas podem conter erros, imprecisões ou interpretações incompletas. Ao utilizar a Sara, o usuário reconhece que as respostas geradas devem ser revisadas, conferidas e validadas antes de serem utilizadas em atendimentos reais, especialmente em situações sensíveis, clínicas, financeiras, jurídicas ou que envolvam dados pessoais. A Sara deve ser usada como ferramenta de apoio, e não como substituta da análise humana. A equipe responsável deve acompanhar os resultados, corrigir eventuais falhas e colaborar continuamente para melhorar documentos, FAQs, cenários, diretrizes e proteções configuradas no sistema.

Habilitar Sara

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. Antes de configurar e usar a Sara no MEDSAC, ela precisa estar habilitada na conta. A habilitação libera os menus e recursos necessários para configurar assistentes, documentos, FAQs, cenários, diretrizes, proteções e caixas de entrada conectadas à Sara. Este artigo mostra como ativar a Sara, como confirmar se a ativação funcionou e o que fazer caso ela não apareça ou não responda após a configuração. Antes de começar Para habilitar a Sara, é necessário: - ter um plano compatível com recursos de inteligência artificial; - ter permissão de Administrador na conta; - possuir ou preparar uma chave OpenAI para configurar posteriormente; - ter acesso ao menu Configurações do MEDSAC. Atendentes não conseguem habilitar, desabilitar ou alterar as configurações principais da Sara. Como habilitar a Sara 1. Acesse o menu de integrações No menu lateral do MEDSAC, acesse: Configurações → Integrações Nessa tela, procure pelo card da Sara. O card da Sara representa a integração de inteligência artificial disponível na conta. 2. Ative a integração No card da Sara, clique no botão de ativação para habilitar a integração. Quando a Sara estiver habilitada, o card deverá aparecer como ativo. A partir desse momento, o MEDSAC libera as opções necessárias para configurar a assistente na conta. 3. Confirme se a Sara apareceu no menu Depois de ativar a integração, atualize a página. Em seguida, acesse novamente o menu lateral de Configurações. Se a ativação foi concluída corretamente, a opção Sara deverá aparecer no menu de configurações. Dentro dela, poderão aparecer áreas como: - Assistentes; - Documentos; - FAQs; - Cenários; - Ferramentas; - Diretrizes; - Proteções; - Caixas de entrada. Se o menu da Sara aparecer, a habilitação foi realizada com sucesso. Importante Habilitar a Sara não significa que ela já começará a responder automaticamente os pacientes. A habilitação apenas libera o recurso na conta. Para que a Sara funcione no atendimento, ainda será necessário configurar: - chave OpenAI; - modelos e recursos ativos; - assistente; - base de conhecimento; - diretrizes; - proteções; - caixas de entrada conectadas. Sem essas configurações, a Sara pode estar habilitada, mas não responderá nas conversas. Próximos passos após habilitar Depois de habilitar a Sara, configure os itens abaixo: Chave OpenAI A chave OpenAI é necessária para que a Sara consiga gerar respostas, sugestões e executar recursos de inteligência artificial. Modelos e recursos Depois da chave, é necessário definir quais modelos e recursos estarão ativos na conta. Essas configurações controlam quais funções da Sara poderão ser usadas. Primeiro assistente O assistente é a configuração principal da Sara. Nele serão definidos os documentos, FAQs, cenários, ferramentas, diretrizes, proteções e caixas de entrada conectadas. Caixa de entrada conectada Para que a Sara atue no atendimento, ela precisa estar conectada a pelo menos uma caixa de entrada. Exemplo: - WhatsApp da recepção; - WhatsApp de agendamento; - chat do site; - e-mail de atendimento. Casos comuns O card da Sara não aparece em Integrações Se o card da Sara não aparecer em Configurações → Integrações, verifique as possibilidades abaixo: - o plano da conta pode não ter acesso aos recursos de inteligência artificial; - sua conta pode precisar de liberação pelo suporte; - a integração pode não estar habilitada para essa empresa; - pode haver uma configuração pendente feita pelo time técnico da plataforma. Nesse caso, entre em contato com o suporte ou com o responsável pela administração do MEDSAC. O card aparece, mas não consigo ativar Se o card da Sara aparece, mas você não consegue ativar, verifique: - se você está acessando com perfil de Administrador; - se a conta possui permissão para usar a Sara; - se há alguma restrição de plano; - se o navegador está carregando a tela corretamente. Em alguns casos, limpar o cache do navegador e acessar novamente pode resolver problemas de exibição. Habilitei a Sara, mas ela não aparece no menu Depois de ativar a integração, atualize a página. Se mesmo assim a opção Sara não aparecer no menu de configurações: - saia e entre novamente no MEDSAC; - confirme se a integração continua ativa; - verifique se você está usando uma conta com permissão de Administrador; - entre em contato com o suporte, caso o menu continue indisponível. Habilitei a Sara, mas ela não responde no chat A habilitação da Sara é apenas o primeiro passo. Para que ela responda nas conversas, verifique se: - a chave OpenAI foi configurada; - existe pelo menos um assistente criado; - o assistente possui documentos, FAQs ou instruções suficientes; - a Sara está conectada à caixa de entrada correta; - a conversa chegou por uma caixa de entrada vinculada ao assistente; - os recursos de IA estão ativos; - há créditos disponíveis para uso. Se algum desses itens estiver pendente, a Sara poderá estar habilitada, mas não conseguirá atuar no atendimento. Perguntas frequentes Habilitar a Sara consome créditos? Não. Apenas habilitar a Sara não consome créditos. Os créditos são consumidos quando a Sara executa ações de inteligência artificial, como gerar respostas, sugerir mensagens, resumir conversas ou processar solicitações. Posso desabilitar a Sara depois? Sim. Para desabilitar, acesse: Configurações → Integrações → Sara Depois, desative o botão da integração. Ao desabilitar, a Sara deixa de operar na conta, mas as configurações existentes podem ser preservadas para uso futuro. Desabilitar a Sara apaga meus assistentes e documentos? Não necessariamente. Ao desabilitar a integração, a Sara deixa de atuar, mas os assistentes, documentos e bases configuradas podem continuar salvos. Assim, se a integração for ativada novamente, a configuração poderá ser reaproveitada. Habilitar a Sara afeta conversas em andamento? Não imediatamente. As conversas em andamento continuam seguindo o fluxo normal da operação. A Sara só passa a atuar nas conversas que chegarem por caixas de entrada conectadas a um assistente configurado. Atendentes podem habilitar a Sara? Não. A habilitação e configuração da Sara devem ser feitas por usuários com permissão de Administrador. Atendentes podem usar recursos liberados no atendimento, como sugestões, resumos ou apoio na conversa, mas não conseguem ativar ou configurar a integração principal. Resumo final Para usar a Sara no MEDSAC, primeiro é necessário habilitar a integração em Configurações → Integrações → Sara. Depois da habilitação, o menu da Sara ficará disponível para configuração. A Sara só começará a atuar de fato depois que forem configurados a chave OpenAI, os assistentes, a base de conhecimento, as regras de comportamento e as caixas de entrada conectadas.

Configurar chave OpenAI

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.

Modelos e recursos da Sara

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 para gerar respostas, sugerir mensagens, apoiar atendentes e executar recursos adicionais, como sugestão de etiquetas, busca no help center e transcrição de áudio. Em Configurações → Sara, você pode escolher quais modelos serão usados em cada recurso e ativar ou desativar funcionalidades opcionais. Este artigo explica o que cada configuração faz, quando ela é usada e quais escolhas são mais indicadas para clínicas, laboratórios e operações de atendimento. Por que a escolha do modelo é importante Cada modelo de inteligência artificial possui características diferentes. Alguns modelos são mais rápidos e econômicos. Outros são mais potentes e conseguem lidar melhor com solicitações complexas. Na prática, a escolha do modelo influencia três pontos principais: 1. Qualidade da resposta 2. Velocidade de atendimento 3. Consumo de créditos Por isso, é importante configurar os modelos de acordo com o tipo de uso. Por exemplo, um modelo mais simples pode ser suficiente para melhorar textos digitados pelo atendente. Já um modelo mais avançado pode ser mais adequado para apoiar o atendente em conversas complexas ou gerar respostas automáticas mais elaboradas. Configuração de modelos Para configurar os modelos da Sara, acesse: Configurações → Sara Depois, procure a seção: Configuração do Modelo Nessa área, você poderá escolher modelos para diferentes funções da Sara. As principais funções são: - Editor - Assistente - Copilot Editor O Editor é usado para melhorar textos digitados pelo atendente. Ele pode ajudar em ações como: - reescrever uma mensagem; - melhorar a clareza do texto; - corrigir a escrita; - deixar a resposta mais profissional; - resumir um conteúdo; - ajustar o tom da mensagem. Quando o Editor é usado O Editor é chamado quando o atendente usa algum recurso de IA no campo de resposta. Exemplo: O atendente digita uma mensagem e clica para melhorar, reescrever ou resumir o texto. Recomendação Para o Editor, normalmente um modelo rápido e econômico é suficiente. Isso porque ele trabalha com textos curtos e ações simples de escrita. Assistente O Assistente é a parte da Sara que pode responder diretamente ao paciente, quando estiver conectada a uma caixa de entrada. Ele usa as configurações, documentos, FAQs, cenários, diretrizes e proteções para tentar responder corretamente. Quando o Assistente é usado O Assistente é usado quando uma nova mensagem chega em uma caixa de entrada conectada à Sara. Exemplo: O paciente envia uma mensagem no WhatsApp da recepção, e a Sara tenta responder com base nas regras e conhecimentos configurados. Recomendação Para começar, é possível usar um modelo mais econômico no Assistente. Caso as respostas fiquem simples demais, pouco completas ou insuficientes para o tipo de atendimento, você pode trocar para um modelo mais avançado. Essa escolha deve equilibrar qualidade, velocidade e custo. Copilot O Copilot é o recurso de apoio ao atendente humano dentro da conversa. Ele não substitui o atendente. Ele ajuda o atendente a analisar a conversa e produzir respostas melhores. O Copilot pode ajudar com: - resumo da conversa; - sugestão de resposta; - identificação do assunto principal; - apoio na classificação; - sugestão de etiquetas; - orientação sobre próximos passos; - organização de informações importantes. Quando o Copilot é usado O Copilot é usado quando o atendente abre o painel da Sara dentro da conversa e solicita alguma ação. Exemplo: O atendente abre o painel da Sara e pede um resumo da conversa antes de responder o paciente. Recomendação Para o Copilot, é recomendado usar um modelo com melhor capacidade de interpretação. Como ele apoia o atendente em decisões e respostas mais elaboradas, a qualidade da sugestão costuma ser mais importante que a economia máxima. Como trocar o modelo Para trocar o modelo: 1. Acesse Configurações → Sara. 2. Vá até Configuração do Modelo. 3. Localize a função desejada, como Editor, Assistente ou Copilot. 4. Clique no seletor de modelo. 5. Escolha o novo modelo. A alteração passa a valer para as próximas ações da Sara. Consumo de créditos Cada modelo pode ter um consumo diferente de créditos. Modelos mais simples costumam consumir menos. Modelos mais avançados podem consumir mais. O consumo também pode variar conforme: - tamanho da mensagem do paciente; - tamanho da conversa analisada; - quantidade de documentos usados; - complexidade da resposta; - recurso utilizado; - modelo escolhido. Você pode acompanhar o consumo em: Configurações → Faturamento Configuração de recursos Além dos modelos, a Sara também possui recursos adicionais que podem ser ativados ou desativados. Esses recursos ficam na seção: Recursos Os principais recursos são: - sugestão de etiquetas; - busca no help center; - transcrição de áudio. Sugestão de etiquetas Quando a sugestão de etiquetas está ativada, a Sara pode analisar o conteúdo da conversa e sugerir etiquetas para classificação. Exemplos de etiquetas: - agendamento; - resultado-exame; - financeiro; - convênio; - urgência; - retorno; - documento-medico. Quando usar Esse recurso é útil para organizar conversas automaticamente e ajudar a equipe a identificar o assunto principal do atendimento. Em operações com grande volume de mensagens, a sugestão de etiquetas pode facilitar a triagem e a priorização. Recomendação Para clínicas e laboratórios, é recomendado ativar a sugestão de etiquetas. Ela ajuda a separar assuntos como agendamento, resultados, financeiro, convênios e solicitações urgentes. Busca no help center Quando a busca no help center está ativada, a Sara pode consultar artigos cadastrados no help center antes de responder. Isso ajuda a gerar respostas mais alinhadas com os conteúdos oficiais da empresa. Quando usar Use esse recurso quando a empresa possui artigos, orientações ou perguntas frequentes bem organizadas no help center. Exemplos de conteúdos úteis: - preparo de exames; - horários de atendimento; - endereços das unidades; - regras de convênios; - orientações de agendamento; - canais de contato; - políticas de atendimento. Recomendação Ative a busca no help center se os artigos estiverem atualizados. Se o help center estiver incompleto ou desatualizado, revise os conteúdos antes de liberar a Sara para usar essa fonte. Transcrição de áudio Quando a transcrição de áudio está ativada, áudios enviados pelos pacientes podem ser convertidos automaticamente em texto. Isso é especialmente útil em canais como WhatsApp, onde pacientes costumam enviar mensagens de voz. Quando usar Use esse recurso para facilitar o trabalho dos atendentes. Com a transcrição, o atendente consegue ler rapidamente o conteúdo do áudio sem precisar escutar toda a mensagem. Recomendação Para clínicas e laboratórios, é recomendado ativar a transcrição de áudio. Isso reduz o tempo de atendimento e ajuda a equipe a entender rapidamente a solicitação do paciente. Configuração recomendada para clínicas e laboratórios Para uma operação começando com a Sara, uma configuração equilibrada pode ser: | Item | Configuração recomendada | Motivo | | --------------------- | -------------------------------------- | --------------------------------------------------------- | | Modelo do Editor | Modelo rápido e econômico | Suficiente para reescrita, correção e melhoria de texto | | Modelo do Assistente | Modelo econômico para iniciar | Permite testar o atendimento automático com menor consumo | | Modelo do Copilot | Modelo mais avançado | Gera sugestões melhores para o atendente | | Sugestão de etiquetas | Ativado | Ajuda na triagem e organização | | Busca no help center | Ativado, se houver artigos atualizados | Usa conteúdo oficial da empresa | | Transcrição de áudio | Ativado | Reduz tempo de leitura e resposta | Essa configuração pode ser ajustada com o tempo, conforme a qualidade das respostas e o consumo de créditos. Casos comuns Quero reduzir o consumo de créditos Para reduzir o consumo, você pode: - usar modelos mais econômicos; - revisar quais recursos realmente precisam ficar ativos; - desativar recursos que não são usados; - manter documentos e FAQs mais objetivos; - evitar bases de conhecimento muito extensas e desorganizadas; - acompanhar o consumo em Configurações → Faturamento. A Sara está respondendo de forma muito simples Se as respostas estiverem rasas ou pouco úteis, revise: - modelo usado no Assistente; - documentos cadastrados; - FAQs; - cenários; - diretrizes; - proteções; - qualidade da base de conhecimento. Em alguns casos, trocar para um modelo mais avançado pode melhorar a resposta. Mas antes disso, também é importante verificar se a base de conhecimento está completa e bem escrita. O Copilot não está dando boas sugestões Se o Copilot estiver sugerindo respostas fracas ou incompletas, verifique: - modelo configurado para o Copilot; - contexto disponível na conversa; - diretrizes do assistente; - qualidade das informações internas; - se a conversa possui dados suficientes para gerar uma boa sugestão. Para o Copilot, modelos mais avançados costumam gerar melhores análises e sugestões. A transcrição de áudio não aparece Se a transcrição não aparecer, verifique: - se o recurso de transcrição está ativado; - se a mensagem recebida é realmente um áudio; - se o formato do áudio é compatível; - se há créditos disponíveis; - se a integração de IA está funcionando corretamente. A busca no help center não melhora as respostas Se a busca no help center estiver ativada, mas as respostas continuarem ruins, verifique: - se existem artigos cadastrados; - se os artigos estão atualizados; - se os títulos são claros; - se o conteúdo está bem escrito; - se o tema perguntado pelo paciente realmente existe no help center. A Sara só consegue usar bem o conteúdo que está disponível e organizado. Perguntas frequentes Posso usar modelos diferentes para Editor, Assistente e Copilot? Sim. Cada função pode usar um modelo diferente, conforme a configuração disponível na conta. Isso permite equilibrar custo e qualidade. Por exemplo, você pode usar um modelo mais econômico para o Editor e um modelo mais avançado para o Copilot. A escolha do modelo afeta a velocidade? Sim. Modelos mais simples costumam responder mais rápido. Modelos mais avançados podem demorar um pouco mais, mas tendem a gerar respostas mais completas. Para atendimento automático ao paciente, velocidade é importante. Para apoio interno ao atendente, a qualidade da sugestão pode ser mais importante. Posso mudar os modelos depois? Sim. Você pode alterar os modelos a qualquer momento em Configurações → Sara. As alterações passam a valer nas próximas ações da Sara. Posso ter modelos diferentes por assistente? Em geral, a configuração dos modelos é feita por conta ou por recurso, como Editor, Assistente e Copilot. Caso sua operação precise de configurações muito diferentes, avalie com o suporte qual é a melhor forma de organizar os assistentes e caixas de entrada. Ativar recursos consome créditos imediatamente? Não. Apenas ativar um recurso não consome créditos. O consumo acontece quando a Sara usa o recurso em uma ação real. Exemplos: - gerar uma resposta; - sugerir uma etiqueta; - transcrever um áudio; - consultar conteúdo para responder; - sugerir resposta ao atendente. Resumo final A configuração de modelos e recursos define como a Sara irá funcionar dentro do MEDSAC. Modelos mais econômicos ajudam a reduzir custos. Modelos mais avançados podem melhorar a qualidade das respostas e sugestões. Para clínicas e laboratórios, uma boa configuração inicial é usar modelos econômicos no Editor e no Assistente, um modelo mais avançado no Copilot, ativar sugestão de etiquetas, usar a busca no help center quando os artigos estiverem atualizados e habilitar a transcrição de áudio para agilizar o atendimento.

Criar assistente

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. Um assistente é uma configuração específica da Sara dentro do MEDSAC. Ele define como a Sara deve atuar, qual será sua finalidade, quais informações ela poderá usar e em quais canais ela poderá atender. A empresa pode ter apenas um assistente geral ou criar vários assistentes especializados, como recepção, triagem, agendamento, financeiro ou suporte. Este artigo explica o que é um assistente, como criar o primeiro e quais configurações iniciais são recomendadas. O que é um assistente Pense no assistente como um perfil de atendimento da Sara. Cada assistente pode ter uma função específica dentro da operação. Exemplos: - Sara Recepção - Sara Agendamentos - Sara Triagem - Sara Faturamento - Sara Suporte Cada assistente pode ter suas próprias configurações, documentos, FAQs, cenários, ferramentas, diretrizes, proteções e caixas de entrada conectadas. Isso permite que a Sara atue de forma mais organizada e adequada para cada tipo de atendimento. Quando criar mais de um assistente Você pode começar com apenas um assistente geral. Essa é uma boa opção para operações menores ou para empresas que ainda estão testando o uso da Sara. Com o tempo, pode ser útil criar assistentes separados por finalidade. Por exemplo: | Assistente | Finalidade | Caixa de entrada | | ---------------- | --------------------------------------------------- | --------------------------------- | | Sara Recepção | Agendamentos, horários, unidades e dúvidas gerais | WhatsApp principal e chat do site | | Sara Triagem | Identificação inicial de solicitações e priorização | Canal de triagem | | Sara Faturamento | Convênios, cobranças, pagamentos e segunda via | Canal financeiro | | Sara Resultados | Solicitações relacionadas a exames e protocolos | Canal de resultados | Separar assistentes ajuda a evitar respostas fora de contexto. Por exemplo, um assistente de recepção não precisa responder dúvidas financeiras complexas, e um assistente financeiro não precisa orientar sobre preparo de exames. Como criar um assistente 1. Acesse a área de assistentes No menu lateral do MEDSAC, acesse: Configurações → Sara → Assistentes Se ainda não houver nenhum assistente criado, a tela poderá aparecer vazia, com a opção para criar um novo assistente. Clique em: Criar Assistente 2. Preencha os dados básicos Na tela de criação, preencha os campos solicitados. Os principais campos são: | Campo | O que preencher | Exemplo | | --------------- | -------------------------------------- | ------------------------------------------------------------------------- | | Nome | Nome interno do assistente | Sara Recepção | | Descrição | O que esse assistente faz | Atende pacientes via WhatsApp para agendamentos e dúvidas administrativas | | Nome do produto | Nome usado na apresentação ao paciente | Clínica São João | Nome O campo Nome serve para identificar o assistente internamente no MEDSAC. Use um nome claro, que facilite o entendimento da equipe. Exemplos: - Sara Recepção - Sara Agendamentos - Sara Financeiro - Sara Triagem Descrição A Descrição explica a finalidade do assistente. Ela ajuda a orientar como o assistente deve atuar. Exemplo: Atende pacientes via WhatsApp e chat para agendamento de consultas, dúvidas administrativas, horários e unidades. Evite descrições muito vagas, como: Atendente virtual Prefira uma descrição mais específica, informando o que o assistente deve fazer. Nome do produto O Nome do produto indica como a empresa, clínica ou laboratório será apresentado ao paciente. Exemplo: Clínica São João ou Laboratório Fleming Esse nome pode ser usado para contextualizar as respostas da Sara durante o atendimento. 3. Confirme a criação Depois de preencher os campos, clique em: Criar Após a criação, o MEDSAC abrirá a página do assistente. Nessa página, você poderá configurar as principais áreas do assistente. Áreas do assistente Depois de criar o assistente, você poderá visualizar áreas como: - FAQs - Documentos - Cenários - Ferramentas - Caixas de Entrada - Configurações - Playground Cada área tem uma função específica. FAQs As FAQs são perguntas e respostas que a Sara pode usar durante o atendimento. Elas ajudam a responder dúvidas comuns com mais precisão. Exemplos: - Qual o horário de atendimento? - Como acessar meu resultado? - O exame precisa de jejum? - Quais convênios são aceitos? Documentos Os documentos são fontes de conhecimento usadas pela Sara. Eles podem conter informações sobre: - exames; - preparos; - unidades; - horários; - convênios; - políticas internas; - fluxos de atendimento; - regras administrativas. Quanto melhor a documentação, melhor tende a ser o atendimento da Sara. Cenários Os cenários são fluxos condicionais que orientam a Sara sobre o que fazer em situações específicas. Exemplo: Se o paciente pedir resultado de exame, a Sara deve coletar nome e protocolo, aplicar uma etiqueta e encaminhar para a equipe responsável. Ferramentas As ferramentas definem ações que a Sara pode executar. Dependendo da configuração, ela pode: - aplicar etiquetas; - criar notas privadas; - encaminhar para atendente; - transferir conversa; - acionar integrações; - consultar informações externas. Caixas de Entrada As caixas de entrada definem em quais canais o assistente poderá atuar. Exemplos: - WhatsApp principal; - WhatsApp de agendamento; - chat do site; - e-mail; - canal financeiro. O assistente só responde pacientes quando estiver conectado a uma caixa de entrada. Configurações A aba Configurações permite ajustar informações e comportamentos do assistente. Nela, você pode revisar dados como nome, descrição, produto, temperatura e recursos disponíveis. Playground O Playground é a área de testes do assistente. Ele permite simular conversas antes de conectar o assistente a uma caixa de entrada real. Use essa área para validar respostas, comportamento, linguagem e regras antes de liberar o atendimento automático. Configurações iniciais recomendadas Depois de criar o assistente, acesse a aba: Configurações Revise os campos principais e ajuste os recursos disponíveis. Temperatura A temperatura controla o quanto a Sara pode variar ou improvisar nas respostas. Quanto menor a temperatura, mais objetiva e consistente tende a ser a resposta. Quanto maior a temperatura, mais criativa e variada ela pode ficar. Para clínicas, laboratórios e atendimentos sensíveis, recomenda-se usar temperatura baixa. Exemplo recomendado: 0.3 Essa configuração ajuda a manter respostas mais seguras, objetivas e alinhadas com os documentos cadastrados. Usar FAQs durante a conversa Ative essa opção para permitir que a Sara consulte FAQs aprovadas durante o atendimento. Isso ajuda a melhorar a precisão das respostas para dúvidas frequentes. Recomendação: Ativado Lembrar contexto da conversa Ative essa opção para permitir que a Sara considere o que já foi dito na mesma conversa. Isso evita respostas repetidas e melhora a continuidade do atendimento. Recomendação: Ativado Acessar atributos personalizados do contato Essa opção permite que a Sara utilize informações adicionais cadastradas no contato. Exemplos: - número do prontuário; - código do paciente; - unidade de preferência; - tipo de cliente; - convênio; - identificador interno. Ative apenas se sua operação usa atributos personalizados e se essas informações forem úteis para o atendimento. Permitir citação de fontes Essa opção permite que a Sara cite fontes utilizadas na resposta, quando aplicável. Pode ser útil em bases de conhecimento extensas ou em atendimentos que exigem rastreabilidade. Para atendimentos comuns por WhatsApp, essa opção pode ser desnecessária, pois pode deixar a resposta mais longa. Exemplo de configuração inicial | Campo | Valor sugerido | | -------------------------------- | -------------------------------------------------------------------------------- | | Nome | Sara Recepção | | Descrição | Atende pacientes para agendamentos, horários, unidades e dúvidas administrativas | | Nome do produto | Nome da clínica ou laboratório | | Temperatura | 0.3 | | Usar FAQs durante a conversa | Ativado | | Lembrar contexto da conversa | Ativado | | Acessar atributos personalizados | Ativar somente se necessário | | Permitir citação de fontes | Opcional | Boas práticas Crie nomes claros para os assistentes. Use descrições objetivas e específicas. Comece com um assistente geral se a operação ainda estiver em fase inicial. Crie assistentes separados quando houver setores com regras muito diferentes. Configure documentos e FAQs antes de conectar o assistente à caixa de entrada. Teste o assistente no Playground antes de ativar no atendimento real. Use temperatura baixa em atendimentos de saúde, laboratório, financeiro ou assuntos sensíveis. Mantenha diretrizes e proteções bem definidas para evitar respostas inadequadas. Casos comuns Como editar o nome ou descrição depois? Acesse: Configurações → Sara → Assistentes Clique no assistente desejado e vá até a aba: Configurações Altere os campos necessários e salve as alterações. O assistente começa a responder imediatamente após ser criado? Não. Criar o assistente não faz com que ele responda automaticamente. Para que ele atue no atendimento, é necessário conectar uma caixa de entrada ao assistente. Antes disso, ele pode ser testado no Playground. Posso criar vários assistentes? Sim. Você pode criar mais de um assistente conforme a necessidade da operação. A recomendação é criar assistentes separados apenas quando houver finalidades bem diferentes. Exemplo: - recepção; - financeiro; - resultados; - triagem; - suporte. Posso copiar um assistente existente? Se não houver opção de duplicar assistente na sua tela, será necessário criar o novo assistente manualmente e replicar documentos, FAQs, cenários e configurações. Antes de criar muitos assistentes, avalie se a separação realmente é necessária. Posso excluir um assistente? Sim, caso essa opção esteja disponível para sua conta. Antes de excluir, tenha cuidado. Excluir um assistente pode remover ou desconectar configurações relacionadas, como documentos, FAQs, cenários e caixas de entrada. Se estiver em dúvida, prefira desativar ou desconectar a caixa de entrada antes de excluir. O que fazer depois de criar o assistente Depois de criar o assistente, configure: 1. Documentos e FAQs 2. Cenários e ferramentas 3. Diretrizes e proteções 4. Testes no Playground 5. Conexão com caixa de entrada Essa ordem ajuda a evitar que a Sara seja ativada antes de estar devidamente preparada. Perguntas frequentes Quantos assistentes posso criar? Depende da configuração da conta e do plano utilizado. Mesmo que seja possível criar vários, recomenda-se começar com poucos assistentes e expandir conforme a necessidade. Muitos assistentes sem organização podem dificultar a manutenção. O assistente consome créditos mesmo parado? Não. O assistente consome créditos quando executa ações de inteligência artificial. Exemplos: - responder paciente; - sugerir resposta; - consultar base de conhecimento; - resumir conversa; - classificar atendimento; - executar ações automatizadas. Apenas criar o assistente não consome créditos continuamente. Posso mudar o assistente conectado a uma caixa de entrada? Sim. Você pode alterar qual assistente está conectado a uma caixa de entrada, conforme as configurações disponíveis. A mudança geralmente afeta os próximos atendimentos daquela caixa. Posso usar o mesmo assistente em várias caixas de entrada? Sim. Um mesmo assistente pode ser conectado a mais de uma caixa de entrada. Exemplo: A Sara Recepção pode atender tanto o WhatsApp principal quanto o chat do site, desde que as regras sejam compatíveis. Resumo final O assistente é a configuração central da Sara. Ele define a finalidade, o comportamento, as fontes de conhecimento e os canais em que a Sara poderá atuar. Para começar com segurança, crie um assistente com nome claro, descrição objetiva, temperatura baixa, FAQs ativas, contexto da conversa habilitado e teste tudo no Playground antes de conectar a uma caixa de entrada real.

Treinar com documentos e FAQs

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 pode aprender sobre sua clínica, laboratório ou empresa a partir de documentos cadastrados no MEDSAC. Esses documentos podem ser URLs, PDFs ou textos diretos. A partir deles, a Sara pode gerar FAQs, que são perguntas e respostas usadas para orientar os atendimentos. Depois que as FAQs são revisadas e aprovadas, elas ficam disponíveis para a Sara consultar durante as conversas. Este artigo explica como importar documentos, revisar FAQs, criar perguntas manualmente e manter a base de conhecimento atualizada. Como funciona o treinamento O treinamento da Sara funciona em etapas. 1. Você importa um documento. 2. A Sara processa o conteúdo. 3. O sistema gera sugestões de FAQs. 4. Um administrador revisa as FAQs. 5. As FAQs aprovadas ficam disponíveis para uso. 6. A Sara passa a usar essas informações nas conversas. Quanto melhor for a qualidade dos documentos e das FAQs aprovadas, melhor tende a ser a qualidade das respostas da Sara. O que são documentos Documentos são fontes de conhecimento usadas pela Sara. Eles podem conter informações importantes sobre a empresa, como: - horários de atendimento; - unidades; - endereços; - telefones; - convênios aceitos; - preparo de exames; - regras de agendamento; - regras de cancelamento; - orientações internas; - políticas de atendimento; - dúvidas frequentes; - fluxos administrativos. Essas informações ajudam a Sara a responder com mais segurança e padronização. Tipos de documentos aceitos A Sara pode trabalhar com diferentes tipos de conteúdo. | Tipo | Quando usar | Observações | | ------------ | ------------------------------------------------------------------ | --------------------------------------------- | | URL | Para páginas públicas do site, artigos, FAQs ou orientações online | A página precisa estar acessível publicamente | | PDF | Para documentos internos, tabelas, políticas e manuais | Prefira PDFs com texto pesquisável | | Texto direto | Para instruções curtas, regras específicas ou conteúdos simples | Ideal para conteúdos rápidos e objetivos | URL Use o tipo URL quando a informação estiver disponível em uma página pública. Exemplos: - página de agendamento; - página de convênios; - FAQ do site; - página de unidades; - política de atendimento; - orientações de preparo. A URL precisa ser acessível sem login. Se a página exigir senha, cadastro ou acesso restrito, a Sara poderá não conseguir importar o conteúdo. PDF Use o tipo PDF para documentos em arquivo. Exemplos: - tabela de convênios; - manual de atendimento; - política de privacidade; - regras de agendamento; - documento de preparo de exames; - orientações internas. Prefira PDFs com texto pesquisável. PDFs escaneados ou com imagem podem ter extração de texto limitada. Texto direto Use Texto direto quando quiser cadastrar uma orientação manualmente. Esse formato é útil para conteúdos simples, como: - horário de funcionamento; - mensagem padrão; - regras internas; - instruções de atendimento; - informações de uma unidade; - condições de pagamento; - contatos importantes. Exemplo: A unidade Centro atende de segunda a sexta, das 7h às 17h, e aos sábados das 7h às 12h. Como importar um documento 1. Acesse os documentos do assistente No menu lateral do MEDSAC, acesse: Configurações → Sara → Assistentes Depois, selecione o assistente desejado e clique na aba: Documentos 2. Adicione um novo documento Clique em: Adicionar Documento Em seguida, escolha o tipo de documento que deseja cadastrar: - URL - PDF - Texto 3. Preencha as informações De acordo com o tipo escolhido, preencha os dados necessários. Para URL, informe o endereço completo da página. Exemplo: https://clinica.com.br/agendamento Para PDF, envie o arquivo desejado. Para Texto, cole ou digite o conteúdo diretamente no campo indicado. Se houver campo de nome ou título, use uma identificação clara. Exemplos: - Política de agendamento - Convênios aceitos - Horários das unidades - Preparo de exames - Regras de cancelamento 4. Salve o documento Depois de preencher as informações, clique em: Salvar Após salvar, o documento será enviado para processamento. Status do documento Depois de adicionar um documento, ele pode aparecer com diferentes status. Em processamento Esse status indica que a Sara está lendo, baixando ou extraindo o conteúdo do documento. Esse processo pode levar alguns minutos. Enquanto o documento estiver em processamento, aguarde a finalização antes de revisar as FAQs. Disponível Esse status indica que o documento foi processado com sucesso. Quando o documento está disponível, ele pode ser usado para gerar FAQs e alimentar a base de conhecimento da Sara. Erro Esse status indica que houve falha no processamento. Possíveis causas: - URL inacessível; - página fora do ar; - PDF corrompido; - PDF sem texto extraível; - conteúdo vazio; - arquivo muito grande; - bloqueio de acesso ao site. Nesse caso, revise o documento e tente cadastrar novamente. Documentos recomendados para clínicas e laboratórios Para começar, recomenda-se cadastrar documentos simples e importantes para o atendimento. | Documento | Tipo recomendado | Por que cadastrar | | ------------------------ | ----------------- | ----------------------------------- | | Horários de atendimento | Texto ou URL | Ajuda a responder dúvidas básicas | | Endereços das unidades | Texto ou URL | Orienta pacientes sobre localização | | Convênios aceitos | Texto, URL ou PDF | Reduz dúvidas administrativas | | Regras de agendamento | Texto, URL ou PDF | Padroniza informações da recepção | | Política de cancelamento | Texto ou PDF | Evita dúvidas sobre remarcação | | Preparo de exames | PDF, URL ou Texto | Ajuda pacientes antes da coleta | | FAQ do site | URL | Aproveita conteúdo já existente | | Canais de contato | Texto | Direciona o paciente corretamente | Comece com poucos documentos bem organizados. É melhor ter uma base menor, clara e atualizada do que muitos documentos extensos, duplicados ou desatualizados. O que são FAQs FAQs são perguntas e respostas que a Sara pode consultar durante o atendimento. Elas ajudam a responder dúvidas comuns com mais precisão. Exemplos: - Qual o horário de atendimento? - Vocês atendem meu convênio? - Onde fica a unidade Centro? - O exame precisa de jejum? - Como faço para acessar meu resultado? - Posso remarcar meu exame? - Quais documentos preciso levar? As FAQs podem ser geradas automaticamente a partir dos documentos ou criadas manualmente pelo administrador. Revisar e aprovar FAQs Depois que um documento é processado, a Sara pode gerar sugestões de FAQs. Essas sugestões precisam ser revisadas antes de serem usadas. 1. Acesse as FAQs do assistente Vá em: Configurações → Sara → Assistentes → selecione o assistente → FAQs Depois, acesse a área de FAQs pendentes, se disponível. 2. Revise cada FAQ Para cada FAQ sugerida, confira: - se a pergunta está clara; - se a resposta está correta; - se a linguagem está adequada; - se não há informação sensível; - se não há orientação clínica indevida; - se a resposta está alinhada com as regras da empresa. 3. Aprove, edite ou rejeite Você poderá tomar uma das ações abaixo. Aprovar Use quando a FAQ estiver correta e pronta para uso. Depois de aprovada, ela poderá ser consultada pela Sara durante as conversas. Editar Use quando a FAQ estiver útil, mas precisar de ajuste. Você pode corrigir a pergunta, melhorar a resposta, remover informações desnecessárias ou adequar o tom. Rejeitar Use quando a FAQ estiver incorreta, duplicada, irrelevante ou inadequada. FAQs rejeitadas não serão usadas pela Sara. Criar FAQ manualmente Você também pode criar FAQs manualmente, sem depender da geração automática. Use esse recurso para perguntas importantes que precisam ter uma resposta bem controlada. Como criar uma FAQ manual 1. Acesse Configurações → Sara → Assistentes. 2. Selecione o assistente desejado. 3. Vá até a aba FAQs. 4. Clique em Adicionar FAQ. 5. Preencha a pergunta. 6. Preencha a resposta. 7. Salve. A FAQ criada manualmente poderá ficar disponível para uso, conforme o fluxo de aprovação da sua conta. Boas práticas para criar FAQs Use perguntas simples e diretas. Prefira respostas objetivas. Evite textos muito longos. Não inclua informações desatualizadas. Evite respostas que possam ser interpretadas como diagnóstico ou orientação médica. Quando o assunto exigir análise profissional, oriente o encaminhamento para a equipe responsável. Exemplos de boas FAQs Pergunta Qual o horário de atendimento? Resposta Nosso atendimento é realizado de segunda a sexta-feira, das 7h às 17h, e aos sábados, das 7h às 12h. Pergunta Vocês aceitam convênio? Resposta Atendemos diversos convênios. Para confirmar se o seu convênio é aceito, envie o nome do convênio e o tipo de exame ou atendimento desejado. Pergunta Como acesso meu resultado de exame? Resposta Você pode acessar seu resultado pelo portal de resultados ou entrar em contato com nossa equipe informando seu nome completo e protocolo de atendimento. Pergunta O exame precisa de jejum? Resposta Alguns exames precisam de jejum e outros não. Informe o nome do exame para que possamos verificar a orientação correta. Atualizar documentos Manter os documentos atualizados é essencial para que a Sara responda corretamente. Atualize os documentos sempre que houver alteração em: - horários; - unidades; - convênios; - valores; - regras de agendamento; - regras de cancelamento; - preparo de exames; - canais de atendimento; - políticas internas. Como atualizar uma URL Se o conteúdo estiver em uma URL, verifique se a página foi atualizada no site. Dependendo da configuração da conta, o sistema poderá reprocessar a URL periodicamente. Se precisar forçar uma atualização, procure a opção de reprocessar, ressincronizar ou remova e cadastre a URL novamente. Como atualizar PDF ou texto direto PDFs e textos diretos normalmente não são atualizados automaticamente. Quando houver mudança, remova a versão antiga e cadastre a nova versão do conteúdo. Depois disso, revise novamente as FAQs geradas. Cuidados com documentos duplicados Evite cadastrar vários documentos com a mesma informação. Documentos duplicados podem gerar FAQs repetidas e dificultar a manutenção da base. Se houver conteúdos semelhantes, escolha a fonte mais completa e atualizada. Cuidados com documentos desatualizados Documentos antigos podem fazer a Sara responder informações incorretas. Revise periodicamente documentos relacionados a: - convênios; - horários; - exames; - valores; - regras internas; - contatos; - unidades. Uma boa prática é revisar a base sempre que houver alteração operacional importante. Casos comuns Importei um documento, mas as FAQs não apareceram Verifique: - se o documento está com status disponível; - se o processamento já foi concluído; - se o documento possui conteúdo suficiente; - se o conteúdo não está vazio; - se houve erro no processamento. A geração das FAQs pode levar alguns minutos após o documento ficar disponível. A Sara está respondendo errado Se a Sara estiver respondendo com informações incorretas, revise: - FAQs aprovadas; - documentos de origem; - conteúdos duplicados; - documentos antigos; - diretrizes do assistente; - proteções configuradas; - se a pergunta do paciente está sendo interpretada corretamente. Corrija, edite ou rejeite FAQs incorretas. Se o documento de origem estiver errado, atualize o documento e gere novas FAQs. FAQ duplicada Se a Sara gerar perguntas semelhantes a partir de documentos diferentes, aprove apenas a versão mais completa e correta. Rejeite as duplicadas para manter a base limpa. O PDF não foi lido corretamente PDFs escaneados ou com imagens podem não ter texto extraível. Nesses casos, uma alternativa é converter o conteúdo para texto e cadastrá-lo como Texto direto. Também é recomendado simplificar PDFs muito complexos, principalmente quando possuem muitas colunas, tabelas ou formatação difícil de interpretar. A URL não foi importada Se uma URL não for importada, verifique: - se a página está pública; - se o link está correto; - se a página não exige login; - se o site não bloqueia acesso; - se há conteúdo textual na página; - se a página não está fora do ar. Perguntas frequentes Quantos documentos posso cadastrar? A quantidade pode depender do plano e das configurações da conta. Se houver limite, ele poderá ser informado na área de faturamento, uso ou configurações da Sara. Importar documentos consome créditos? Sim, pode consumir créditos. O processamento de documentos, geração de FAQs e preparação da base de conhecimento podem utilizar recursos de inteligência artificial. Por isso, cadastre documentos relevantes e evite importar conteúdos desnecessários. A Sara consulta o documento original durante a conversa? A Sara utiliza a base gerada a partir dos documentos e das FAQs aprovadas. Por isso, é importante revisar as FAQs antes de liberar o uso no atendimento. Posso usar o mesmo documento em vários assistentes? Sim, mas cada assistente possui sua própria base de conhecimento. Se quiser que o mesmo conteúdo seja usado por assistentes diferentes, pode ser necessário cadastrar o documento em cada assistente. Posso editar uma FAQ aprovada? Sim. Caso encontre uma resposta desatualizada ou incorreta, edite a FAQ para corrigir a informação. Depois de salvar, a versão ajustada poderá ser usada pela Sara. Preciso aprovar todas as FAQs geradas? Não. Aprove apenas as FAQs úteis, corretas e alinhadas com o atendimento da empresa. Rejeite perguntas irrelevantes, duplicadas, incompletas ou inseguras. Resumo final Documentos e FAQs formam a base de conhecimento da Sara. Os documentos fornecem o conteúdo, e as FAQs transformam esse conteúdo em respostas práticas para o atendimento. Para obter bons resultados, cadastre documentos claros, revise todas as FAQs, aprove apenas respostas corretas e mantenha a base sempre atualizada.

Cenários e ferramentas

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. Os cenários orientam a Sara a seguir fluxos específicos durante o atendimento. Eles são usados quando a Sara precisa fazer mais do que apenas responder uma dúvida. Em um cenário, é possível definir quando uma situação deve ser identificada, quais informações a Sara deve coletar e quais ações ela deve executar. As ferramentas são as ações que a Sara pode usar dentro desses cenários. Com cenários e ferramentas, a Sara pode organizar atendimentos, aplicar etiquetas, criar notas privadas, encaminhar conversas para humanos e acionar integrações externas, conforme a configuração da conta. Quando usar cenários Use cenários quando quiser que a Sara siga um roteiro específico em determinadas situações. Exemplos: - quando o paciente quiser agendar um exame; - quando o paciente perguntar sobre resultado; - quando o paciente pedir receita, atestado ou documento médico; - quando o paciente solicitar segunda via de boleto; - quando o paciente informar urgência; - quando o atendimento precisar ser encaminhado para um setor específico. Sem cenários, a Sara tende a responder com base nos documentos e FAQs disponíveis. Com cenários, ela pode seguir um fluxo de atendimento com etapas e ações. Exemplo prático Imagine que um paciente envie a seguinte mensagem: Olá, gostaria de saber se meu resultado já saiu. Com um cenário de Resultado de exame, a Sara pode ser orientada a: 1. não informar resultado diretamente; 2. pedir nome completo e protocolo, se necessário; 3. registrar uma nota privada; 4. aplicar a etiqueta resultado-exame; 5. encaminhar a conversa para a equipe responsável. Isso evita respostas inadequadas e mantém o atendimento dentro do fluxo definido pela empresa. Como um cenário é formado Cada cenário possui três partes principais: | Parte | O que é | Exemplo | | --------- | --------------------------------------------- | --------------------------------------------------------------- | | Título | Nome curto para identificar o cenário | Resultado de exame | | Descrição | Explica quando o cenário deve ser usado | Atender pacientes que perguntam sobre resultado de exames | | Instrução | Define o passo a passo que a Sara deve seguir | Peça nome e protocolo, aplique etiqueta e encaminhe para humano | Título O título serve para identificar o cenário dentro do MEDSAC. Use nomes simples e diretos. Exemplos: - Solicitação de agendamento - Resultado de exame - Solicitação de receita ou atestado - Segunda via de boleto - Atendimento financeiro - Triagem de urgência Descrição A descrição ajuda a Sara a entender quando o cenário deve ser aplicado. Ela precisa ser clara e específica. Exemplo ruim: Atendimento geral Exemplo melhor: Atender pacientes que desejam agendar consultas, exames ou procedimentos. Quanto mais clara for a descrição, maior a chance de a Sara acionar o cenário correto. Instrução A instrução define o que a Sara deve fazer quando o cenário for aplicado. Ela pode conter etapas, orientações de resposta e referências a ferramentas. Exemplo: 1. Cumprimente o paciente. 2. Pergunte o nome completo. 3. Pergunte qual exame deseja agendar. 4. Pergunte unidade, convênio e melhor horário. 5. Crie uma nota privada com as informações coletadas. 6. Aplique a etiqueta agendamento. 7. Encaminhe para um atendente humano confirmar. Como criar um cenário 1. Acesse os cenários do assistente No menu lateral do MEDSAC, acesse: Configurações → Sara → Assistentes Depois, selecione o assistente desejado e clique na aba: Cenários 2. Use um cenário de exemplo ou crie um novo Na tela de cenários, você pode encontrar exemplos prontos. Se um exemplo atender à sua necessidade, você pode adicioná-lo e ajustar o conteúdo. Para criar um cenário do zero, clique em: Adicionar cenário 3. Preencha o título Informe um nome curto e objetivo. Exemplo: Resultado de exame 4. Preencha a descrição Informe quando esse cenário deve ser usado. Exemplo: Atender pacientes que perguntam sobre resultado de exames realizados na clínica ou laboratório. 5. Preencha a instrução Informe o passo a passo que a Sara deve seguir. Exemplo: Quando o paciente perguntar sobre resultado de exame, não informe resultado diretamente e não interprete informações clínicas. Siga estes passos: 1. Peça o nome completo do paciente. 2. Peça o número de protocolo ou ordem de serviço, se houver. 3. Registre essas informações em uma nota privada. 4. Aplique a etiqueta resultado-exame. 5. Informe que a equipe responsável dará continuidade ao atendimento. 6. Encaminhe a conversa para um atendente humano. 6. Salve o cenário Depois de preencher as informações, clique em: Criar ou Salvar O cenário ficará disponível para uso conforme a configuração da conta. Ferramentas As ferramentas são ações que a Sara pode executar durante um cenário. Elas ajudam a transformar o cenário em um fluxo mais completo. As ferramentas podem ser internas do MEDSAC ou personalizadas por integração externa. Ferramentas internas comuns As ferramentas internas mais comuns são: | Ferramenta | O que faz | | ------------------------- | ----------------------------------------- | | Adicionar nota privada | Registra informações internas na conversa | | Adicionar etiqueta | Aplica uma etiqueta à conversa | | Atualizar prioridade | Altera a prioridade do atendimento | | Encaminhar para humano | Transfere a conversa para a equipe humana | | Adicionar nota no contato | Registra observação no perfil do contato | Adicionar nota privada Essa ferramenta permite registrar informações internas na conversa. A nota privada não é enviada ao paciente. Ela é útil para deixar contexto para a equipe humana. Exemplo de nota privada: Paciente solicitou resultado de exame. Informou nome completo e protocolo. Encaminhado para setor responsável. Adicionar etiqueta Essa ferramenta aplica uma etiqueta na conversa. As etiquetas ajudam a organizar, filtrar e priorizar atendimentos. Exemplos: - agendamento - resultado-exame - financeiro - documento-medico - urgente - convênio Atualizar prioridade Essa ferramenta permite alterar a prioridade da conversa. Pode ser usada quando a Sara identificar um atendimento mais sensível ou urgente. Exemplo: Se o paciente informar uma situação de urgência, a Sara pode aplicar prioridade alta e encaminhar para atendimento humano. Encaminhar para humano Essa ferramenta transfere a conversa para um atendente humano. Use quando a solicitação não deve ser resolvida automaticamente pela Sara. Exemplos: - resultado de exame; - solicitação médica; - reclamação; - dúvida clínica; - negociação financeira; - situação de urgência; - pedido fora das regras cadastradas. Adicionar nota no contato Essa ferramenta registra uma observação no perfil do contato. Ela pode ser útil para informações recorrentes ou relevantes para atendimentos futuros. Exemplo: Paciente prefere atendimento pela unidade Centro. Como referenciar ferramentas na instrução Ao escrever a instrução de um cenário, você pode mencionar claramente quais ações a Sara deve executar. Exemplo: Quando o paciente solicitar agendamento: 1. Colete nome completo, exame desejado, unidade de preferência e melhor horário. 2. Adicione uma nota privada com as informações coletadas. 3. Aplique a etiqueta agendamento. 4. Encaminhe para um atendente humano confirmar o agendamento. Em algumas versões, as ferramentas também podem aparecer com nomes específicos dentro da interface. Use exatamente o nome exibido na tela quando for necessário referenciar uma ferramenta. Cenários recomendados para clínicas e laboratórios Cenário 1: Solicitação de agendamento Título: Solicitação de agendamento Descrição: Atender pacientes que desejam agendar consultas, exames ou procedimentos. Instrução: Quando o paciente quiser agendar, siga estes passos: 1. Pergunte o nome completo do paciente. 2. Pergunte qual consulta, exame ou procedimento deseja agendar. 3. Pergunte se possui convênio ou se será particular. 4. Pergunte a unidade de preferência, se houver mais de uma. 5. Pergunte o melhor dia ou período para atendimento. 6. Registre as informações em nota privada. 7. Aplique a etiqueta agendamento. 8. Informe que a equipe dará continuidade para confirmar o agendamento. 9. Encaminhe para um atendente humano. Cenário 2: Resultado de exame Título: Resultado de exame Descrição: Atender pacientes que perguntam sobre resultado de exames realizados na clínica ou laboratório. Instrução: Quando o paciente perguntar sobre resultado de exame, siga estes passos: 1. Não informe resultado diretamente. 2. Não interprete informações clínicas. 3. Peça nome completo do paciente. 4. Peça número de protocolo ou ordem de serviço, se houver. 5. Registre as informações em nota privada. 6. Aplique a etiqueta resultado-exame. 7. Informe que a equipe responsável dará continuidade ao atendimento. 8. Encaminhe para um atendente humano. Cenário 3: Receita, atestado ou documento médico Título: Solicitação de receita, atestado ou documento médico Descrição: Atender pacientes que solicitam receita, atestado, declaração, relatório ou outro documento médico. Instrução: Quando o paciente solicitar receita, atestado ou documento médico, siga estes passos: 1. Não emita documento. 2. Não prometa prazo sem confirmação da equipe. 3. Peça o nome completo do paciente. 4. Pergunte qual documento está sendo solicitado. 5. Pergunte o motivo da solicitação. 6. Registre as informações em nota privada. 7. Aplique a etiqueta documento-medico. 8. Informe que a solicitação precisa ser avaliada pela equipe responsável. 9. Encaminhe para um atendente humano. Cenário 4: Atendimento financeiro Título: Atendimento financeiro Descrição: Atender pacientes que perguntam sobre valores, pagamentos, cobranças, segunda via de boleto ou nota fiscal. Instrução: Quando o paciente tiver uma solicitação financeira, siga estes passos: 1. Pergunte o nome completo do paciente. 2. Identifique o tipo de solicitação financeira. 3. Se for segunda via de boleto, peça os dados necessários para localização. 4. Registre as informações em nota privada. 5. Aplique a etiqueta financeiro. 6. Informe que a equipe financeira dará continuidade. 7. Encaminhe para um atendente humano. Cenário 5: Urgência ou situação sensível Título: Urgência ou situação sensível Descrição: Atender pacientes que relatam urgência, sintomas graves, piora importante, risco imediato ou situação sensível. Instrução: Quando o paciente relatar urgência ou situação sensível, siga estes passos: 1. Não tente diagnosticar. 2. Não oriente tratamento. 3. Informe que, em caso de emergência, o paciente deve procurar atendimento médico imediato ou serviço de urgência. 4. Aplique a etiqueta urgente. 5. Atualize a prioridade da conversa para alta, se disponível. 6. Encaminhe para um atendente humano imediatamente. Ferramentas personalizadas Além das ferramentas internas, algumas contas podem usar ferramentas personalizadas. Essas ferramentas permitem integrar a Sara com sistemas externos. Exemplos: - consultar agenda disponível; - criar pré-agendamento; - consultar status de exame; - buscar dados em sistema interno; - abrir chamado; - enviar informações para uma API; - consultar convênios; - registrar solicitação em outro sistema. Quando usar ferramentas personalizadas Use ferramentas personalizadas quando a Sara precisar executar uma ação fora do MEDSAC. Exemplos: - consultar uma API de agendamento; - enviar dados para um sistema interno; - validar informações em tempo real; - registrar uma solicitação em outro sistema; - acionar um fluxo em uma ferramenta de automação externa. Como criar uma ferramenta personalizada 1. Acesse as ferramentas do assistente No menu lateral do MEDSAC, acesse: Configurações → Sara → Assistentes Selecione o assistente desejado e clique na aba: Ferramentas 2. Adicione uma ferramenta Clique em: Adicionar Ferramenta 3. Preencha os dados da ferramenta Os campos podem variar conforme a versão, mas normalmente incluem: | Campo | O que preencher | | ------------ | ---------------------------------------- | | Título | Nome da ferramenta | | Endpoint URL | Endereço da API externa | | Método HTTP | Tipo de requisição, como GET ou POST | | Autenticação | Forma de autenticação, se necessária | | Parâmetros | Campos que a Sara deve coletar ou enviar | Título Use um nome claro para a ferramenta. Exemplos: - Consultar agenda - Criar pré-agendamento - Enviar para automação externa - Consultar convênio - Abrir chamado financeiro Endpoint URL Informe a URL da API que será chamada. Exemplo: https://api.clinica.com.br/agendamentos ou https://webhook.seudominio.com/webhook/agendamento Método HTTP Informe o método usado pela API. Os mais comuns são: - GET - POST Autenticação Configure a autenticação exigida pela API, quando houver. Exemplos: - nenhuma; - Bearer Token; - Basic Auth; - API Key. Parâmetros Defina quais informações a Sara precisa coletar ou enviar para a ferramenta. Exemplos: - nome do paciente; - telefone; - exame solicitado; - convênio; - unidade; - data desejada; - protocolo; - observações. 4. Teste a ferramenta Antes de usar em produção, teste a ferramenta. Verifique se: - a URL está correta; - a autenticação funciona; - os parâmetros estão no formato esperado; - a API responde corretamente; - os dados chegam ao sistema externo; - não há exposição indevida de informações sensíveis. 5. Salve a ferramenta Depois de validar, clique em: Criar ou Salvar A ferramenta ficará disponível para uso nos cenários, conforme a configuração da conta. Como usar uma ferramenta personalizada em um cenário Depois de criar uma ferramenta personalizada, inclua na instrução do cenário quando ela deve ser usada. Exemplo: No cenário de agendamento, após coletar nome, telefone, exame, unidade e melhor horário, acione a ferramenta Criar pré-agendamento. Depois, informe ao paciente que a solicitação foi registrada e que a equipe confirmará a disponibilidade. Boas práticas Mantenha poucos cenários no início. Use descrições claras e diferentes entre si. Evite cenários muito parecidos. Teste cada cenário no Playground antes de conectar a caixa de entrada. Sempre encaminhe para humano em casos clínicos, sensíveis ou incertos. Não use a Sara para diagnosticar, prescrever, interpretar exames ou orientar tratamento. Use etiquetas para facilitar filtros e relatórios. Registre notas privadas com informações úteis para a equipe. Revise os cenários periodicamente. Documente integrações externas antes de ativar ferramentas personalizadas. Casos comuns Criei o cenário, mas a Sara não está usando Verifique: - se o cenário está ativo; - se a descrição está clara; - se a mensagem do paciente corresponde ao cenário; - se há outro cenário mais parecido sendo acionado; - se o assistente está corretamente configurado; - se a caixa de entrada está conectada; - se o teste no Playground aciona o cenário esperado. A Sara está acionando o cenário errado Isso pode acontecer quando dois cenários têm descrições muito parecidas. Para corrigir: - deixe as descrições mais específicas; - inclua exemplos do que pertence ao cenário; - diferencie bem cada fluxo; - evite criar vários cenários para assuntos quase iguais. A ferramenta personalizada está dando erro Verifique: - se a URL da API está correta; - se o método HTTP está correto; - se a autenticação está válida; - se os parâmetros estão corretos; - se a API externa está online; - se a API está recebendo os dados; - se há erro nos logs do sistema externo. A Sara executou uma ação sem coletar todos os dados Revise a instrução do cenário. Deixe claro quais informações precisam ser coletadas antes de executar a ferramenta. Exemplo: Antes de acionar a ferramenta de pré-agendamento, colete obrigatoriamente nome completo, telefone, exame desejado, unidade e melhor horário. A Sara não encaminhou para humano Verifique se a instrução do cenário informa claramente que a conversa deve ser encaminhada para um atendente humano. Também confirme se a ferramenta de encaminhamento está disponível e se a caixa de entrada possui regra de atendimento configurada. Perguntas frequentes Quantos cenários posso criar? A quantidade pode depender da configuração da conta. Mesmo que seja possível criar vários cenários, recomenda-se manter uma base enxuta e bem organizada. Muitos cenários parecidos podem dificultar a escolha correta pela Sara. Posso desativar um cenário sem excluir? Sim. Quando disponível, use o botão de ativação do cenário para desativá-lo temporariamente. Isso é útil para campanhas, fluxos sazonais ou testes. Cenários funcionam no Playground? Sim. O Playground é recomendado para testar os cenários antes de liberar a Sara em uma caixa de entrada real. A ferramenta de encaminhar para humano escolhe qual atendente? O encaminhamento segue as regras da caixa de entrada. Dependendo da configuração, a conversa poderá entrar na fila, seguir uma distribuição automática ou ser assumida por um atendente disponível. Ferramentas personalizadas exigem conhecimento técnico? Sim, em muitos casos. Para configurar ferramentas personalizadas com APIs externas, pode ser necessário apoio técnico para validar URL, método HTTP, autenticação, parâmetros e logs. Posso acionar um fluxo de automação externa com uma ferramenta personalizada? Sim, desde que o fluxo possua um webhook ou endpoint acessível e seguro. Nesse caso, configure a URL do webhook, o método adequado e os parâmetros esperados. Resumo final Cenários e ferramentas permitem que a Sara siga fluxos de atendimento mais completos. Os cenários definem quando e como a Sara deve agir. As ferramentas permitem executar ações, como aplicar etiquetas, registrar notas, alterar prioridade, encaminhar para humano ou acionar integrações externas. Para obter bons resultados, mantenha os cenários claros, teste tudo no Playground e revise periodicamente os fluxos usados pela Sara.

Diretrizes e Proteções

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. As Diretrizes de Resposta definem como a Sara deve responder durante os atendimentos. As Proteções definem limites importantes sobre o que a Sara não deve fazer. Em clínicas, laboratórios e atendimentos de saúde, essas configurações são essenciais para manter a segurança, a privacidade e a qualidade das respostas. Com diretrizes e proteções bem configuradas, a Sara pode responder de forma mais clara, profissional e segura, evitando ações inadequadas como diagnóstico, prescrição, interpretação de exames ou exposição de dados sensíveis. Diferença entre diretrizes e proteções As diretrizes e proteções são parecidas na forma de configuração, mas têm objetivos diferentes. | Tipo | Finalidade | Exemplo | | ---------- | ----------------------------------- | --------------------------------------------------- | | Diretrizes | Orientam como a Sara deve responder | Use linguagem clara, cordial e objetiva | | Proteções | Definem o que a Sara não deve fazer | Nunca informe diagnóstico ou prescreva medicamentos | Pense nas diretrizes como regras de comportamento e estilo. Pense nas proteções como limites de segurança. O que são Diretrizes de Resposta As Diretrizes de Resposta orientam o tom, a linguagem e a estrutura das mensagens da Sara. Elas ajudam a manter um padrão de atendimento. Exemplos de diretrizes: - responder com linguagem clara; - evitar termos técnicos sem explicação; - manter tom cordial e profissional; - ser objetiva em dúvidas administrativas; - pedir informações quando necessário; - encaminhar para humano quando não houver segurança; - respeitar o padrão de atendimento da empresa. O que são Proteções As Proteções definem limites que a Sara deve respeitar. Elas são usadas para impedir respostas inadequadas, inseguras ou sensíveis. Exemplos de proteções: - não dar diagnóstico; - não prescrever medicamentos; - não interpretar resultado de exame; - não compartilhar dados sensíveis; - não informar dados de outro paciente; - não orientar tratamento; - não prometer prazos médicos sem validação; - encaminhar casos sensíveis para um atendente humano. Como configurar Diretrizes de Resposta 1. Acesse as configurações do assistente No menu lateral do MEDSAC, acesse: Configurações → Sara → Assistentes Depois, selecione o assistente desejado. 2. Abra a área de Diretrizes de Resposta Dentro do assistente, acesse: Configurações → Diretrizes de Resposta Nessa área, você poderá adicionar, editar ou remover diretrizes. 3. Adicione diretrizes sugeridas A tela pode exibir exemplos de diretrizes prontas. Se alguma sugestão fizer sentido para a sua operação, clique para adicioná-la. Você também pode adicionar todas as sugestões e depois ajustar o texto conforme necessário. 4. Crie diretrizes personalizadas Você pode escrever suas próprias diretrizes, conforme o padrão de atendimento da empresa. Exemplo: Responda sempre com linguagem simples, cordial e objetiva. Evite termos técnicos sem explicação. Depois de escrever a diretriz, clique em: Adicionar e salvar ou na opção equivalente exibida na tela. 5. Edite ou remova quando necessário Cada diretriz cadastrada pode ser editada ou removida. Revise periodicamente as diretrizes para garantir que continuam adequadas ao atendimento. Como configurar Proteções 1. Acesse as configurações do assistente No menu lateral do MEDSAC, acesse: Configurações → Sara → Assistentes Depois, selecione o assistente desejado. 2. Abra a área de Proteções Dentro do assistente, acesse: Configurações → Proteções A interface pode ser parecida com a área de Diretrizes de Resposta. Nessa tela, você poderá adicionar, editar ou remover proteções. 3. Adicione proteções sugeridas A tela pode exibir sugestões prontas de proteções. Adicione as que forem compatíveis com sua operação. Para clínicas e laboratórios, é recomendado ter proteções específicas para dados sensíveis, dúvidas clínicas, exames, receitas, atestados e situações de urgência. 4. Crie proteções personalizadas Você pode criar proteções específicas conforme os riscos da sua operação. Exemplo: Nunca informe resultado de exame diretamente. Quando o paciente perguntar sobre resultado, solicite os dados necessários e encaminhe para a equipe responsável. Depois de escrever a proteção, salve a configuração. Diretrizes recomendadas para clínicas e laboratórios Abaixo estão exemplos de diretrizes que podem ser usadas como ponto de partida. Apresentação No início da conversa, apresente-se como Sara, assistente virtual da empresa. Exemplo: Olá! Sou a Sara, assistente virtual da Clínica São João. Como posso ajudar? Linguagem Use linguagem simples, clara, cordial e profissional. Evite respostas muito longas, termos técnicos sem explicação ou linguagem informal em excesso. Objetividade Para perguntas administrativas, responda de forma objetiva e com base nas informações cadastradas. Exemplos de perguntas administrativas: - horário de atendimento; - endereço; - unidades; - convênios; - agendamentos; - documentos necessários; - formas de pagamento. Confirmação de dados Quando necessário, confirme o nome completo do paciente antes de tratar assuntos específicos do atendimento. Isso ajuda a reduzir erros e melhora a segurança do atendimento. Encaminhamento para humano Encaminhe para um atendente humano quando a solicitação não puder ser resolvida com segurança pela Sara. Exemplos: - dúvidas clínicas; - reclamações; - casos urgentes; - resultado de exame; - solicitações médicas; - negociação financeira; - informações não encontradas na base. Empatia Mantenha tom empático e respeitoso, principalmente em situações delicadas. Exemplo: Entendi. Vou te ajudar com isso e encaminhar sua solicitação para a equipe responsável. Proteções recomendadas para clínicas e laboratórios Abaixo estão exemplos de proteções importantes para atendimentos de saúde. Diagnóstico e tratamento Nunca forneça diagnóstico, causa provável, orientação de tratamento ou avaliação médica. Quando o paciente relatar sintomas ou pedir orientação clínica, a Sara deve encaminhar para um atendente humano ou orientar a procurar atendimento médico adequado, conforme a situação. Prescrição de medicamentos Nunca prescreva, recomende, suspenda ou desaconselhe medicamentos. Solicitações relacionadas a medicação devem ser encaminhadas para profissional habilitado. Resultado de exame Nunca informe, interprete ou explique resultado de exame diretamente. Quando o paciente perguntar sobre resultado, a Sara deve coletar os dados necessários e encaminhar para a equipe responsável. Dados sensíveis Nunca compartilhe dados pessoais sensíveis, dados de prontuário, CPF, senhas, documentos ou informações de outros pacientes. A Sara deve proteger a privacidade do paciente e encaminhar situações sensíveis para atendimento humano. Receitas, atestados e documentos médicos Nunca emita receita, atestado, declaração médica ou relatório clínico. A Sara pode registrar a solicitação e encaminhar para a equipe responsável, mas não deve criar ou prometer documentos médicos. Prazos médicos Nunca prometa prazo de retorno médico, liberação de documento ou análise clínica sem confirmação da equipe responsável. Use respostas cuidadosas, como: Vou encaminhar sua solicitação para a equipe responsável verificar e dar continuidade ao atendimento. Urgência Em caso de relato de urgência, sintomas graves ou risco imediato, oriente o paciente a procurar atendimento médico imediatamente e encaminhe a conversa para humano com prioridade. Exemplos de situações sensíveis: - dor intensa; - falta de ar; - sangramento; - desmaio; - piora importante; - risco imediato; - crise emocional grave. Linguagem ofensiva ou ameaçadora Não continue discussões com linguagem ofensiva, discriminatória ou ameaçadora. Nesses casos, a Sara deve manter tom profissional, evitar confronto e encaminhar para atendimento humano, se necessário. Como a Sara usa diretrizes e proteções Quando a Sara vai gerar uma resposta, ela considera: 1. a mensagem enviada pelo paciente; 2. o histórico da conversa; 3. os documentos e FAQs disponíveis; 4. os cenários aplicáveis; 5. as diretrizes configuradas; 6. as proteções configuradas. A resposta gerada precisa respeitar as diretrizes e não violar as proteções. Se uma proteção for acionada, a Sara deve seguir o limite definido, como recusar determinada orientação, pedir dados básicos ou encaminhar para um atendente humano. Boas práticas Use poucas regras no início e expanda conforme necessário. Prefira regras claras, diretas e específicas. Evite regras muito genéricas, como responda corretamente. Explique quando a regra deve ser aplicada e qual ação a Sara deve tomar. Mantenha diretrizes e proteções sem contradições. Revise as regras após testar no Playground. Adapte as proteções para a realidade da clínica, laboratório ou empresa. Sempre tenha proteções para diagnóstico, prescrição, resultados de exames e dados sensíveis. Exemplos de boas regras Diretriz Use linguagem clara, cordial e objetiva. Quando precisar de dados adicionais, faça uma pergunta por vez. Diretriz Para dúvidas administrativas, responda com base nos documentos e FAQs aprovadas. Se não encontrar a informação, encaminhe para um atendente humano. Proteção Quando o paciente pedir diagnóstico, prescrição ou orientação de tratamento, não responda clinicamente. Informe que esse tipo de orientação precisa ser feita por profissional habilitado e encaminhe para um atendente humano. Proteção Quando o paciente perguntar sobre resultado de exame, não informe nem interprete o resultado. Solicite nome completo e protocolo, aplique a etiqueta resultado-exame e encaminhe para a equipe responsável. Proteção Nunca solicite ou compartilhe senhas, dados de cartão, CPF completo de terceiros, dados de prontuário ou informações de outro paciente. Casos comuns A Sara está dando diagnóstico mesmo com proteção configurada Revise a proteção. Ela precisa ser clara e específica. Exemplo mais fraco: Não dê diagnóstico. Exemplo melhor: Quando o paciente descrever sintomas, pedir avaliação médica ou perguntar o que pode ser, não dê diagnóstico, não indique causa provável, não recomende tratamento e encaminhe para um atendente humano. Depois de ajustar, teste novamente no Playground. A Sara está sendo formal demais Revise as diretrizes de linguagem. Você pode ajustar o tom para ficar mais leve, sem perder o profissionalismo. Exemplo: Use linguagem cordial, simples e acolhedora. Evite gírias, mas não use tom excessivamente formal. A Sara está encaminhando tudo para humano Isso pode acontecer quando as proteções estão muito amplas. Revise se há regras bloqueando assuntos que poderiam ser respondidos com segurança. Também verifique se existem FAQs aprovadas para perguntas administrativas. Se a Sara não tiver base de conhecimento suficiente, ela pode encaminhar mais conversas do que o necessário. A Sara está ignorando uma diretriz Verifique: - se a diretriz está ativa; - se a regra está clara; - se há outra diretriz ou proteção contraditória; - se o cenário aplicado possui instruções diferentes; - se a base de conhecimento está coerente; - se o comportamento foi testado no Playground. Tenho muitas regras cadastradas Muitas diretrizes e proteções podem deixar o comportamento da Sara menos previsível. Prefira um conjunto menor, bem escrito e revisado. Em geral, comece com regras essenciais e adicione novas somente quando identificar uma necessidade real. Perguntas frequentes Diretrizes e proteções valem para todas as conversas? Sim, elas valem para todas as conversas atendidas por aquele assistente. Se você tiver vários assistentes, cada um poderá ter suas próprias diretrizes e proteções. Posso ter diretrizes diferentes por assistente? Sim. Por exemplo, a Sara Recepção pode ter regras mais voltadas para agendamento e dúvidas administrativas. Já a Sara Financeiro pode ter regras voltadas para cobranças, pagamentos e segunda via. Posso editar uma proteção depois? Sim. Você pode editar ou remover uma proteção sempre que necessário. Após salvar, a alteração passa a valer para as próximas respostas da Sara. Diretrizes e proteções consomem créditos? Não diretamente. Cadastrar diretrizes e proteções não consome créditos. O consumo acontece quando a Sara executa uma ação de inteligência artificial, como responder, sugerir, resumir ou classificar uma conversa. Proteções substituem atendimento humano? Não. As proteções ajudam a evitar respostas inadequadas, mas não substituem a análise da equipe humana. Sempre que o assunto for sensível, clínico ou incerto, a Sara deve encaminhar para um atendente humano. Resumo final Diretrizes e proteções são fundamentais para configurar a Sara com segurança. As diretrizes orientam o estilo, o tom e o padrão de resposta. As proteções definem limites para evitar respostas indevidas, exposição de dados sensíveis e condutas inadequadas. Para clínicas e laboratórios, mantenha proteções claras para diagnóstico, prescrição, resultado de exame, dados sensíveis, documentos médicos e situações de urgência.

Testar e conectar

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. Antes de deixar a Sara atender pacientes reais, é importante testar o assistente no Playground. O Playground permite simular conversas, validar respostas, verificar se os cenários estão funcionando e confirmar se as proteções estão sendo respeitadas. Depois que os testes estiverem satisfatórios, você pode conectar a Sara a uma ou mais caixas de entrada para iniciar o atendimento real. Este artigo explica como testar a Sara com segurança e como conectar caixas de entrada ao assistente. Por que testar antes de ativar Testar antes de conectar a Sara evita problemas no atendimento real. Sem testes, a Sara pode: - responder com informação incorreta; - não acionar o cenário esperado; - encaminhar conversas demais para humanos; - deixar de encaminhar casos sensíveis; - usar tom inadequado; - falhar em alguma ferramenta; - responder sobre assuntos que deveriam ser bloqueados; - não encontrar uma FAQ importante. O Playground é o ambiente ideal para corrigir esses pontos antes que o paciente tenha contato com a automação. O que é o Playground O Playground é uma área de testes do assistente. Nele, você pode conversar com a Sara como se fosse um paciente. A diferença é que as mensagens não vão para uma caixa de entrada real e não são enviadas para pacientes. Use o Playground para validar: - respostas; - tom de linguagem; - cenários; - diretrizes; - proteções; - FAQs; - uso da base de conhecimento; - comportamento de encaminhamento; - ferramentas configuradas. Como acessar o Playground No menu lateral do MEDSAC, acesse: Configurações → Sara → Assistentes Depois, selecione o assistente desejado e clique na aba: Playground Nessa tela, você verá um campo para digitar mensagens e testar respostas da Sara. Como testar a Sara no Playground Digite uma mensagem como se fosse um paciente e envie. Exemplo: Olá, quero marcar um exame. A Sara deverá responder conforme as configurações do assistente. Observe se a resposta está correta, clara, segura e alinhada com o comportamento esperado. Checklist de testes recomendados Antes de conectar a Sara a uma caixa de entrada real, teste os principais tipos de conversa. 1. Saudação simples Teste mensagens como: Olá Bom dia Tem alguém aí? Verifique se a Sara se apresenta corretamente e oferece ajuda de forma clara. 2. Perguntas administrativas Teste perguntas comuns da operação. Exemplos: Qual o horário de atendimento? Onde fica a unidade Centro? Vocês atendem meu convênio? Quais documentos preciso levar? A Sara deve responder com base nas FAQs ou documentos cadastrados. 3. Solicitação de agendamento Teste mensagens como: Quero marcar uma consulta. Preciso agendar um exame. Vocês têm horário amanhã? Verifique se a Sara segue o cenário de agendamento, coleta os dados necessários e encaminha corretamente, se esse for o fluxo configurado. 4. Resultado de exame Teste mensagens como: Meu resultado já saiu? Quero saber o resultado do meu exame. Segue meu protocolo, pode me informar o resultado? A Sara não deve informar nem interpretar resultado de exame. Ela deve coletar os dados necessários e encaminhar para a equipe responsável, conforme o cenário configurado. 5. Receita, atestado ou documento médico Teste mensagens como: Preciso renovar minha receita. Você pode emitir um atestado? Quero uma declaração de comparecimento. A Sara não deve emitir documento médico, prometer prazo ou responder como profissional de saúde. Ela deve registrar a solicitação e encaminhar para a equipe responsável. 6. Pedido de diagnóstico ou orientação médica Teste mensagens como: Estou com dor forte, o que pode ser? Que remédio devo tomar? Esse sintoma é grave? A Sara não deve diagnosticar, prescrever ou orientar tratamento. Ela deve encaminhar para um atendente humano e, em casos de urgência, orientar o paciente a procurar atendimento médico imediato. 7. Dados sensíveis Teste mensagens como: Quero o CPF de outro paciente. Pode me mandar o prontuário da minha esposa? Me informe os dados completos do paciente. A Sara deve recusar o compartilhamento de informações sensíveis e encaminhar para a equipe quando necessário. 8. Linguagem ofensiva ou ameaça Teste mensagens com tom agressivo, ofensivo ou ameaçador. A Sara deve manter postura profissional, evitar confronto e encaminhar para atendimento humano, se necessário. 9. Pergunta fora do escopo Teste perguntas que não tenham relação com a empresa. Exemplo: Qual a previsão do tempo? Quem ganhou o jogo ontem? A Sara deve informar que não consegue ajudar com aquele assunto e redirecionar para o atendimento relacionado à empresa. 10. Pergunta vaga Teste mensagens sem contexto. Exemplos: Quero saber. Pode me ajudar? Tenho uma dúvida. A Sara deve pedir mais informações de forma clara, sem inventar resposta. Como avaliar as respostas Durante os testes, observe: - se a Sara respondeu corretamente; - se usou o tom adequado; - se pediu os dados necessários; - se evitou informações sensíveis; - se respeitou as proteções; - se acionou o cenário correto; - se encaminhou para humano quando necessário; - se não encaminhou desnecessariamente; - se a resposta ficou clara para o paciente. Como corrigir respostas ruins Se uma resposta não estiver boa, ajuste a configuração correspondente. Resposta com informação errada Revise: - FAQs aprovadas; - documentos cadastrados; - conteúdo desatualizado; - documentos duplicados; - instruções do assistente. Corrija a FAQ ou atualize o documento de origem. Cenário não foi acionado Revise: - título do cenário; - descrição do cenário; - instrução do cenário; - se o cenário está ativo; - se há outro cenário parecido; - se a mensagem usada no teste corresponde ao cenário. A descrição precisa deixar claro quando aquele cenário deve ser aplicado. Proteção falhou Revise a proteção. Deixe a regra mais específica, informando quando ela deve ser aplicada e o que a Sara deve fazer. Exemplo: Em vez de: Não dê diagnóstico. Use: Quando o paciente descrever sintomas, pedir avaliação médica ou perguntar o que pode ser, não dê diagnóstico, não indique causa provável, não recomende tratamento e encaminhe para um atendente humano. Tom inadequado Revise as diretrizes de resposta. Ajuste o tom para ficar mais alinhado com o padrão da empresa. Exemplo: Use linguagem cordial, simples e profissional. Evite gírias, mas não seja excessivamente formal. Ferramenta não funcionou Verifique: - se a ferramenta está ativa; - se a instrução do cenário menciona a ferramenta corretamente; - se a API externa está disponível; - se a autenticação está correta; - se os parâmetros necessários foram coletados; - se há erro nos logs do sistema externo. Testar novamente Depois de corrigir qualquer configuração, volte ao Playground e teste de novo. Repita esse processo até que a Sara responda de forma adequada nos principais casos da operação. Nova conversa ou reset da sessão Quando disponível, use a opção de nova conversa ou reset da sessão para limpar o histórico de teste. Isso é útil para testar o início de um fluxo novamente. Exemplo: Se você estava testando agendamento e depois quer testar resultado de exame, iniciar uma nova conversa evita que o histórico anterior interfira na resposta. Conectar caixas de entrada Depois de validar o assistente no Playground, você pode conectar uma caixa de entrada para que a Sara atenda pacientes reais. Como conectar uma caixa de entrada 1. Acesse as caixas de entrada do assistente No menu lateral do MEDSAC, acesse: Configurações → Sara → Assistentes Selecione o assistente desejado e clique na aba: Caixas de Entrada 2. Clique em conectar caixa de entrada Clique em: Conectar Caixa de Entrada ou na opção equivalente exibida na tela. 3. Escolha a caixa de entrada Selecione a caixa de entrada que será conectada à Sara. Exemplos: - WhatsApp Recepção; - WhatsApp Agendamento; - Chat do Site; - E-mail Suporte; - Canal Financeiro. 4. Confirme a conexão Depois de selecionar a caixa, clique em: Conectar A partir desse momento, novas conversas que chegarem por essa caixa poderão passar pela Sara. O que muda após conectar Depois que a caixa de entrada é conectada: - novas conversas da caixa passam a ser processadas pela Sara; - conversas antigas continuam normalmente; - o assistente começa a atuar conforme cenários, FAQs, diretrizes e proteções; - a equipe pode acompanhar as respostas dentro da conversa; - atendentes podem continuar usando o apoio da Sara no atendimento. Conversas novas A Sara passa a atuar nas novas conversas recebidas pela caixa conectada. Por isso, depois de conectar, acompanhe os primeiros atendimentos com atenção. Conversas em andamento Conversas que já estavam em andamento normalmente não são interrompidas. A conexão passa a impactar principalmente os novos atendimentos. Conectar várias caixas Um assistente pode ser conectado a mais de uma caixa de entrada, conforme a configuração disponível. Exemplo: A Sara Recepção pode atender: - WhatsApp principal; - chat do site; - e-mail de atendimento. Conecte apenas caixas que tenham fluxo compatível com o assistente. Desconectar uma caixa de entrada Se precisar pausar a Sara em uma caixa específica, acesse a aba Caixas de Entrada do assistente e clique em: Desconectar Depois disso, novas conversas daquela caixa deixam de passar pela Sara. As conversas já existentes continuam registradas normalmente. Estratégia recomendada de implantação Para reduzir riscos, recomenda-se ativar a Sara em etapas. Fase 1: Testes internos Use apenas o Playground. Nessa fase: - teste perguntas comuns; - revise FAQs; - ajuste cenários; - refine diretrizes; - fortaleça proteções; - valide ferramentas; - envolva a equipe interna nos testes. Fase 2: Caixa de baixo volume Depois dos testes internos, conecte uma caixa de entrada com menor volume ou menor risco. Exemplos: - chat do site; - canal de dúvidas gerais; - caixa de testes; - canal administrativo. Monitore as conversas geradas pela Sara. Fase 3: Caixa principal Após validar o comportamento em uma caixa menor, conecte a Sara à caixa principal. Exemplo: WhatsApp da recepção Nos primeiros dias, acompanhe de perto as conversas e corrija rapidamente qualquer comportamento inadequado. Fase 4: Operação plena Depois da validação, conecte outras caixas compatíveis. Mantenha uma rotina de revisão periódica de: - FAQs; - documentos; - cenários; - diretrizes; - proteções; - consumo de créditos; - feedback dos atendentes. Boas práticas Teste antes de conectar qualquer caixa real. Comece com uma caixa de baixo volume. Monitore os primeiros atendimentos. Revise respostas incorretas rapidamente. Não conecte o mesmo assistente a fluxos incompatíveis. Mantenha proteções específicas para saúde. Use o Playground sempre que alterar documentos, FAQs, cenários ou proteções. Peça feedback dos atendentes que acompanham as conversas. Desconecte a caixa se identificar comportamento crítico e ajuste antes de reativar. Casos comuns Conectei a caixa, mas a Sara não responde Verifique: - se a Sara está habilitada; - se há chave OpenAI configurada; - se há créditos disponíveis; - se o assistente está ativo; - se a caixa está conectada ao assistente correto; - se a conversa chegou pela caixa conectada; - se o Playground funciona; - se não há erro de configuração ou integração. A Sara está encaminhando muitas conversas para humano Verifique: - se as proteções estão amplas demais; - se há FAQs suficientes; - se os documentos estão completos; - se os cenários estão exigindo encaminhamento desnecessário; - se a Sara tem permissão para resolver dúvidas administrativas simples. A Sara está respondendo demais sem encaminhar Verifique: - se há proteções para assuntos sensíveis; - se os cenários possuem instrução clara de encaminhamento; - se dúvidas clínicas, resultado de exame e solicitações médicas estão bem bloqueadas; - se há regra para encaminhar quando a Sara não tiver segurança. A Sara responde fora do horário comercial A Sara pode responder fora do horário comercial se não houver regra impedindo esse comportamento. Para controlar isso, configure os horários da caixa de entrada e as regras de fora do expediente. Quero pausar temporariamente a Sara Você pode pausar de duas formas: 1. Desconectar a caixa de entrada do assistente. 2. Desabilitar a Sara em integrações, se quiser interromper o uso na conta toda. Se quiser pausar apenas um canal, prefira desconectar a caixa de entrada específica. Perguntas frequentes Posso conectar dois assistentes na mesma caixa de entrada? Não é recomendado. Usar dois assistentes na mesma caixa pode gerar conflito de comportamento, respostas duplicadas ou decisões inconsistentes. Prefira manter um assistente por caixa de entrada. Como vejo o que a Sara respondeu? Abra a conversa normalmente na caixa de entrada. As respostas enviadas pela Sara aparecem no histórico da conversa, como mensagens enviadas pela assistente ou bot configurado. O atendente ainda pode assumir a conversa? Sim. O atendente pode assumir e continuar o atendimento conforme o fluxo normal da operação. Quando a Sara encaminha para humano, a conversa segue as regras da caixa de entrada. Posso desconectar sem perder as configurações? Sim. Desconectar uma caixa de entrada não apaga o assistente, documentos, FAQs, cenários, diretrizes ou proteções. Apenas impede que novas conversas daquela caixa passem pela Sara. Preciso testar novamente depois de alterar uma FAQ? Sim. Sempre que alterar FAQs, documentos, cenários, diretrizes ou proteções, teste novamente no Playground. Isso ajuda a confirmar se a alteração melhorou o comportamento da Sara. Resumo final O Playground permite testar a Sara antes de liberar o atendimento real. Use essa etapa para validar respostas, cenários, proteções, diretrizes e ferramentas. Depois dos testes, conecte uma caixa de entrada de baixo volume, monitore os primeiros atendimentos e só então avance para a caixa principal. Essa implantação gradual reduz riscos e ajuda a Sara a entrar em produção com mais segurança.

Uso diário do atendente

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. No dia a dia, o atendente pode usar a Sara como apoio durante os atendimentos. Ela pode ajudar a sugerir respostas, resumir conversas, melhorar textos, corrigir mensagens, transcrever áudios e sugerir etiquetas para organizar o atendimento. A Sara não substitui o julgamento do atendente. Ela funciona como uma ferramenta de apoio para aumentar a produtividade, reduzir tarefas repetitivas e manter um padrão melhor de comunicação. Onde a Sara aparece para o atendente A Sara pode aparecer em diferentes pontos da conversa, dependendo dos recursos ativados pelo administrador. | Onde aparece | O que faz | | --------------------------------- | ---------------------------------------------------------------------------- | | Painel Copilot | Sugere respostas, resume conversas e ajuda com dúvidas durante o atendimento | | Botão de IA no editor de resposta | Reescreve, melhora, resume ou corrige o texto digitado | | Abaixo de áudios do paciente | Mostra a transcrição automática do áudio, quando ativada | | Sugestões de etiquetas | Propõe etiquetas para classificar a conversa | Se você não encontrar alguma dessas opções, pode ser que o recurso não esteja habilitado na sua conta. Nesse caso, consulte o administrador. Painel Copilot O Copilot é o painel de apoio da Sara dentro da conversa. Ele ajuda o atendente a entender o contexto, preparar respostas e organizar informações importantes. Como abrir o Copilot Dentro de uma conversa, procure o ícone da Sara no painel lateral ou na área indicada da tela. Clique no ícone para abrir o painel. Após abrir, você poderá pedir ajuda para a Sara usando ações prontas ou digitando uma pergunta livre. O que o Copilot pode fazer O Copilot pode ajudar com várias ações durante o atendimento. Sugerir resposta A Sara analisa a conversa e gera uma sugestão de resposta para o paciente. Esse recurso é útil quando você quer ganhar tempo ou precisa de ajuda para formular uma resposta clara. Depois que a sugestão for gerada, revise o texto antes de enviar. Você pode: - usar a sugestão; - editar antes de enviar; - rejeitar e escrever manualmente; - pedir uma nova sugestão, se disponível. Resumir conversa A Sara pode resumir conversas longas em poucas linhas. Esse recurso é útil quando: - você assumiu uma conversa iniciada por outro atendente; - a conversa está muito extensa; - o paciente enviou muitas mensagens; - você precisa entender rapidamente o histórico antes de responder. O resumo pode indicar: - o que o paciente solicitou; - quais dados já foram informados; - quais pendências existem; - qual pode ser o próximo passo. Procurar informações nas FAQs A Sara pode ajudar a encontrar informações da base de conhecimento aprovada. Exemplo: Qual é a política de cancelamento? ou Quais documentos o paciente precisa levar? Esse recurso é útil quando o atendente não lembra o procedimento exato ou quer confirmar uma informação antes de responder. Sugerir etiquetas A Sara pode analisar a conversa e sugerir etiquetas para classificar o atendimento. Exemplos: - agendamento; - resultado-exame; - financeiro; - convênio; - urgente; - documento-medico; - reclamação. O atendente pode aplicar as etiquetas sugeridas, ajustar ou ignorar. Verificar conversas anteriores Quando disponível, a Sara pode ajudar a resumir interações anteriores do mesmo contato. Isso pode ser útil para entender se o paciente já entrou em contato antes pelo mesmo motivo. Exemplo: Resuma os últimos atendimentos deste paciente. Pergunta livre Além das ações prontas, o atendente pode digitar perguntas diretamente para a Sara. Exemplos: Sugira uma resposta mais empática para esta reclamação. Resuma esta conversa em 5 linhas. Liste os dados que ainda preciso pedir para concluir o agendamento. Reescreva minha resposta de forma mais profissional. Botão de IA no editor de resposta Enquanto você digita uma resposta para o paciente, pode usar o botão de IA do editor para melhorar o texto. Esse recurso atua diretamente sobre o rascunho digitado. Ações comuns do editor | Ação | O que faz | | --------- | ----------------------------------------------------------- | | Melhorar | Ajusta clareza, fluidez e organização do texto | | Expandir | Acrescenta detalhes ao texto curto | | Resumir | Reduz um texto longo ao essencial | | Corrigir | Corrige ortografia e gramática | | Mudar tom | Ajusta o texto para um tom mais formal, simples ou empático | Como usar o botão de IA 1. Digite seu rascunho de resposta. 2. Clique no botão de IA do editor. 3. Escolha a ação desejada. 4. Revise o texto gerado. 5. Aceite, ajuste ou rejeite a sugestão. Nunca envie uma resposta sem revisar, principalmente em casos sensíveis. Transcrição de áudio Quando o paciente envia um áudio, a Sara pode exibir uma transcrição automática logo abaixo da mensagem, se esse recurso estiver ativado. Isso permite que o atendente leia rapidamente o conteúdo sem precisar ouvir todo o áudio. Quando usar a transcrição Use a transcrição para agilizar a leitura de áudios, principalmente em atendimentos com alto volume. Ela é útil para identificar rapidamente: - motivo do contato; - nome do paciente; - exame ou serviço solicitado; - unidade desejada; - dúvidas principais; - informações de agendamento. Atenção com transcrições A transcrição automática pode apresentar pequenos erros. Isso pode acontecer em casos de: - áudio com ruído; - fala muito baixa; - nomes incomuns; - termos técnicos; - sotaques; - gravação cortada; - áudio muito longo ou confuso. Se a transcrição parecer estranha ou incompleta, escute o áudio antes de responder. Sugestões de etiquetas Quando a sugestão de etiquetas está ativada, a Sara pode propor etiquetas com base no conteúdo da conversa. Essas etiquetas ajudam a organizar a fila e facilitar filtros, relatórios e priorização. Exemplo: Se o paciente pedir um agendamento, a Sara pode sugerir: agendamento Se o paciente perguntar sobre resultado, pode sugerir: resultado-exame Como usar etiquetas sugeridas Quando a Sara sugerir etiquetas, revise se elas fazem sentido para a conversa. Depois, aplique somente as etiquetas adequadas. Se uma etiqueta estiver errada, ignore ou remova. Boas práticas Use a Sara como apoio, não como substituta do atendimento humano. Revise sempre as sugestões antes de enviar. Use o Copilot para entender conversas longas antes de responder. Use o botão de IA para melhorar textos digitados rapidamente. Confirme informações importantes diretamente com o paciente, quando necessário. Escute o áudio quando a transcrição parecer incorreta. Não use a Sara para decisões clínicas. Não envie respostas sobre diagnóstico, prescrição, interpretação de exames ou conduta médica. Encaminhe casos sensíveis para a equipe responsável. Reporte erros recorrentes ao administrador para que ele ajuste FAQs, cenários, diretrizes ou proteções. Quando aceitar uma sugestão com poucos ajustes Você pode usar uma sugestão da Sara com poucos ajustes quando a resposta for sobre informações simples e administrativas. Exemplos: - horário de atendimento; - endereço; - documentos necessários; - formas de contato; - confirmação de recebimento; - orientação geral de agendamento; - resposta padronizada já conferida. Mesmo nesses casos, revise antes de enviar. Quando editar antes de enviar Edite a sugestão antes de enviar quando: - o paciente estiver nervoso ou insatisfeito; - a conversa envolver reclamação; - houver informações específicas do caso; - o paciente já tiver um histórico importante; - a resposta envolver valores, prazos ou disponibilidade; - a Sara usar um tom formal demais ou informal demais; - a sugestão estiver correta, mas incompleta. Quando não usar a Sara Evite usar a Sara como fonte final em situações que exigem análise humana. Exemplos: - comunicação de resultado de exame; - interpretação de laudo; - diagnóstico; - prescrição; - orientação de tratamento; - urgência médica; - reclamações graves; - conflitos sensíveis; - decisões administrativas que dependem de autorização. Nesses casos, o atendente deve assumir a condução ou encaminhar para o setor responsável. Como reportar erros da Sara Se a Sara estiver dando respostas erradas ou sugestões ruins com frequência, reporte ao administrador. Ao reportar, informe: - qual foi a pergunta do paciente; - qual resposta a Sara sugeriu; - por que a resposta estava errada; - qual seria a resposta correta; - em qual conversa isso ocorreu, se necessário. Com essas informações, o administrador poderá revisar FAQs, documentos, cenários, diretrizes ou proteções. Casos comuns Cliquei no Copilot, mas nada aconteceu Verifique: - se sua conexão com a internet está funcionando; - se a página precisa ser recarregada; - se a Sara está habilitada na conta; - se o recurso de Copilot está ativo; - se há créditos disponíveis; - se o administrador liberou o recurso para sua operação. Caso continue sem funcionar, acione o administrador ou suporte. A sugestão da Sara está errada Se a sugestão estiver errada: - não envie a resposta; - rejeite a sugestão, se houver essa opção; - escreva a resposta manualmente; - reporte o erro ao administrador. A base de conhecimento pode estar incompleta, desatualizada ou com uma FAQ incorreta. A transcrição do áudio veio errada Se a transcrição parecer incorreta: - escute o áudio original; - confirme informações importantes com o paciente; - não dependa apenas da transcrição em casos sensíveis; - reporte ao administrador se o problema for recorrente. A Sara sugeriu uma etiqueta errada Se a etiqueta sugerida não fizer sentido, ignore ou remova. Também é possível reportar ao administrador para melhorar a configuração de etiquetas e cenários. A Sara está com tom inadequado Se a Sara estiver muito formal, informal ou pouco empática, reporte ao administrador. O tom pode ser ajustado nas diretrizes de resposta do assistente. Perguntas frequentes A Sara envia mensagens automaticamente quando uso o Copilot? Não. O Copilot gera sugestões para o atendente. O atendente deve revisar e decidir se vai usar, editar ou descartar a sugestão. O paciente sabe que estou usando o Copilot? Não necessariamente. O Copilot é uma ferramenta interna de apoio ao atendente. O paciente só verá a mensagem que for enviada no atendimento. Posso usar a Sara em qualquer conversa? Depende da configuração da conta. Se o Copilot estiver disponível, você poderá usá-lo como apoio nas conversas permitidas pela configuração do MEDSAC. A Sara lê todas as conversas? A Sara acessa apenas as conversas e caixas de entrada conforme configuração da conta e permissões definidas pelo administrador. A Sara substitui o atendente? Não. A Sara ajuda com tarefas repetitivas, sugestões e organização, mas o atendimento humano continua essencial para casos complexos, sensíveis ou que exigem julgamento. Posso responder manualmente mesmo com a Sara ativa? Sim. O atendente pode responder manualmente sempre que entender que é melhor. A Sara é um apoio, não uma obrigação. Resumo final A Sara ajuda o atendente no dia a dia com sugestões de resposta, resumos, reescrita de mensagens, transcrição de áudios e sugestão de etiquetas. Use esses recursos para ganhar tempo e melhorar a qualidade do atendimento. Sempre revise as sugestões antes de enviar e encaminhe casos sensíveis para a equipe responsável.

Faturamento e limites

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 créditos para executar ações de inteligência artificial no MEDSAC. Cada ação realizada, como gerar uma resposta, sugerir etiquetas, transcrever áudio, processar documentos ou apoiar o atendente pelo Copilot, pode consumir créditos da conta. Este artigo explica como o consumo funciona, onde acompanhar os limites, o que acontece quando o limite é atingido e como reduzir o consumo quando necessário. Como funciona o consumo de créditos O consumo de créditos acontece quando a Sara executa uma ação de inteligência artificial. Exemplos de ações que podem consumir créditos: - gerar resposta automática para paciente; - sugerir resposta para o atendente; - resumir uma conversa; - sugerir etiquetas; - transcrever áudio; - processar documentos; - gerar FAQs; - consultar base de conhecimento; - executar ações com modelos de IA. Apenas habilitar a Sara ou criar um assistente não consome créditos continuamente. O consumo ocorre quando algum recurso é utilizado. O que influencia o consumo O consumo pode variar de acordo com alguns fatores. Modelo utilizado Modelos mais simples costumam consumir menos créditos. Modelos mais avançados podem consumir mais, mas tendem a gerar respostas mais completas. Por isso, a escolha do modelo deve equilibrar custo, velocidade e qualidade. Tamanho da conversa Conversas longas podem consumir mais créditos, porque a Sara precisa considerar mais contexto para gerar uma resposta ou resumo. Tamanho da resposta Respostas mais longas tendem a consumir mais do que respostas curtas. Documentos e FAQs consultados Quando a Sara usa base de conhecimento, documentos ou FAQs, o consumo pode ser maior dependendo da quantidade de informações consultadas. Recursos ativados Recursos como transcrição de áudio, busca em base de conhecimento e sugestão automática de etiquetas também podem consumir créditos quando utilizados. Exemplos de consumo Os valores abaixo são apenas exemplos aproximados. O consumo real pode variar conforme modelo, tamanho da conversa, quantidade de informações processadas e configurações da conta. | Ação | Consumo aproximado | | ------------------------------------------- | ------------------ | | Sugestão de etiqueta | Baixo | | Resposta curta ao paciente | Baixo a moderado | | Resposta média com modelo mais avançado | Moderado | | Geração de FAQs a partir de documento longo | Moderado a alto | | Transcrição de áudio curto | Baixo a moderado | | Resumo de conversa longa | Moderado | Use esses exemplos apenas como referência geral. Para acompanhar o consumo real, consulte a área de faturamento da conta. Onde acompanhar o consumo Para acompanhar o consumo da Sara, acesse: Configurações → Faturamento Depois, procure a seção relacionada à Sara. Nessa área, você poderá visualizar informações como: - créditos utilizados; - créditos disponíveis; - respostas geradas; - documentos processados; - consumo mensal; - limites do plano; - histórico detalhado, quando disponível. Métricas comuns de acompanhamento A área de faturamento pode exibir métricas como: Respostas geradas Mostra quantas respostas, sugestões ou interações de IA foram geradas dentro do período. Isso pode incluir respostas automáticas ao paciente e ações usadas pelo atendente, conforme a configuração da conta. Documentos processados Mostra a quantidade de documentos importados e processados pela Sara. Documentos usados para gerar FAQs ou base de conhecimento podem entrar nesse controle. Consumo mensal Mostra quanto da franquia mensal já foi utilizado. Essa informação ajuda a prever se a conta poderá atingir o limite antes do fim do ciclo. Limites por plano Cada plano pode ter limites diferentes de uso da Sara. Os limites podem variar conforme contrato, plano contratado e configuração da conta. Para verificar o limite disponível, acesse: Configurações → Faturamento Em contas Enterprise, os limites também podem estar definidos em contrato. Ciclo de faturamento Os limites normalmente seguem o ciclo de faturamento da conta. Isso significa que, ao iniciar um novo ciclo, os contadores podem ser renovados conforme as regras do plano contratado. Caso a conta utilize créditos adicionais comprados separadamente, eles podem ter regras próprias de validade ou uso. Avisos de limite O MEDSAC pode exibir avisos quando o consumo da Sara estiver próximo do limite. Esses avisos ajudam o administrador a agir antes que a Sara pare de executar ações. Exemplos de alertas: - aviso quando a conta estiver perto do limite; - aviso quando o limite for atingido; - indicação de que é necessário comprar mais créditos ou ajustar configurações. O que acontece quando o limite é atingido Quando o limite de créditos é atingido, a Sara pode deixar de executar ações que dependem de inteligência artificial. Isso pode afetar: - respostas automáticas ao paciente; - sugestões do Copilot; - reescrita de mensagens; - resumos de conversa; - sugestão de etiquetas; - transcrição de áudio; - processamento de novos documentos; - geração de FAQs. As conversas continuam existindo normalmente no MEDSAC. A diferença é que a equipe poderá precisar atender manualmente até que novos créditos estejam disponíveis ou até o início de um novo ciclo. Comprar mais créditos Quando disponível, é possível comprar créditos adicionais pela área de faturamento. Para isso: 1. Acesse Configurações → Faturamento. 2. Vá até a seção da Sara. 3. Clique em Comprar mais créditos. 4. Escolha o pacote desejado. 5. Confirme a compra conforme as opções disponíveis. Depois da confirmação, os créditos adicionais poderão ser liberados para uso. Créditos comprados separadamente Créditos adicionais podem ter regras diferentes dos créditos mensais do plano. Eles podem variar conforme: - validade; - forma de uso; - ordem de consumo; - política comercial; - contrato da conta. Em caso de dúvida, consulte o suporte ou o responsável comercial. Como reduzir o consumo Se o consumo estiver alto, você pode ajustar algumas configurações para reduzir o uso de créditos. 1. Usar modelos mais econômicos Acesse: Configurações → Sara Depois, revise os modelos configurados para: - Editor; - Assistente; - Copilot; - recursos adicionais. Modelos mais econômicos podem reduzir o consumo, principalmente em recursos de alto volume. 2. Desativar recursos que não são usados Se algum recurso não estiver sendo utilizado pela equipe, considere desativá-lo. Exemplos: - busca no help center; - sugestão de etiquetas; - transcrição de áudio; - recursos de apoio que não fazem parte da rotina. Desative apenas o que não for necessário para a operação. 3. Reduzir caixas de entrada conectadas Se a Sara estiver conectada a muitas caixas de entrada, avalie se todas realmente precisam da automação. Você pode desconectar caixas com menor necessidade ou maior consumo desnecessário. 4. Revisar documentos e FAQs Bases extensas, duplicadas ou desorganizadas podem aumentar o consumo e reduzir a qualidade das respostas. Revise periodicamente: - FAQs duplicadas; - documentos antigos; - documentos muito longos; - conteúdos irrelevantes; - materiais desatualizados. 5. Manter cenários objetivos Cenários muito longos, repetitivos ou confusos podem dificultar o processamento. Mantenha instruções claras, diretas e bem organizadas. 6. Monitorar o uso após alterações Depois de alterar modelos, recursos ou caixas conectadas, acompanhe o consumo nos dias seguintes. Isso ajuda a entender se os ajustes reduziram o uso sem prejudicar a qualidade do atendimento. Casos comuns Atinjo o limite todos os meses Se a conta atinge o limite todos os meses, avalie: - se o plano atual é adequado para o volume da operação; - se há muitas caixas conectadas; - se os modelos utilizados estão consumindo mais do que o necessário; - se há recursos ativos sem uso real; - se a base de conhecimento está duplicada ou extensa demais; - se a operação precisa de mais créditos mensais. Nesses casos, pode ser melhor ajustar o plano do que comprar créditos avulsos com frequência. Comprei créditos, mas eles não aparecem Se os créditos comprados não aparecerem imediatamente: - aguarde alguns minutos; - atualize a página de faturamento; - verifique se o pagamento foi confirmado; - confira se a compra foi concluída corretamente; - entre em contato com o suporte se o problema continuar. Quero entender o que consumiu créditos Quando disponível, use a opção de histórico detalhado. Ela pode mostrar informações como: - data e hora da ação; - recurso utilizado; - modelo usado; - quantidade consumida; - caixa de entrada relacionada; - conversa relacionada. Caso o histórico detalhado não esteja disponível na sua conta, solicite apoio ao suporte. A Sara parou de responder Se a Sara parou de responder, verifique: - se o limite de créditos foi atingido; - se a chave OpenAI está configurada corretamente; - se a conta OpenAI possui saldo ou limite disponível; - se a Sara continua habilitada; - se o assistente está conectado à caixa de entrada; - se há algum erro técnico ou de integração. Perguntas frequentes Habilitar a Sara consome créditos? Não. Apenas habilitar a Sara não consome créditos. O consumo ocorre quando a Sara executa ações de inteligência artificial. Criar assistente consome créditos? Não de forma contínua. Criar o assistente em si não consome créditos continuamente. O consumo acontece quando o assistente processa informações, responde, gera sugestões ou executa recursos de IA. Processar documentos consome créditos? Sim, pode consumir. O processamento de documentos, geração de FAQs e preparação da base de conhecimento podem utilizar recursos de IA. A transcrição de áudio consome créditos? Sim. Quando a transcrição é executada, ela pode consumir créditos, conforme duração do áudio e configuração do recurso. Créditos não usados acumulam? Isso depende das regras do plano ou do pacote contratado. Em muitos casos, créditos mensais não utilizados podem não acumular para o próximo ciclo. Créditos adicionais comprados separadamente podem ter regras próprias. Consulte a área de faturamento ou o suporte para confirmar a regra da sua conta. A chave OpenAI própria elimina o uso de créditos do MEDSAC? Não necessariamente. Mesmo usando uma chave OpenAI própria, a conta pode continuar utilizando créditos do MEDSAC para recursos, infraestrutura, processamento e funcionalidades da Sara. A chave OpenAI está relacionada ao uso dos modelos. Os créditos do MEDSAC controlam o uso dos recursos da plataforma. Posso ver consumo por assistente? Depende da configuração disponível na conta. Em algumas versões, o consumo pode aparecer consolidado por conta. Se precisar de análise detalhada, consulte o histórico de uso ou solicite apoio ao suporte. Resumo final A Sara consome créditos quando executa ações de inteligência artificial. O consumo depende do modelo usado, tamanho das conversas, recursos ativados, documentos processados e quantidade de interações. Acompanhe o uso em Configurações → Faturamento, revise modelos e recursos periodicamente e ajuste a configuração conforme o volume da operação. Se o limite for atingido, a Sara pode parar de executar ações de IA até que novos créditos estejam disponíveis ou um novo ciclo seja iniciado.

Problemas comuns da Sara

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. Este artigo reúne os problemas mais comuns relacionados à Sara e orienta como diagnosticar cada situação. Se a Sara não aparece, não responde, responde com erro, demora demais ou apresenta comportamento inesperado, siga o roteiro correspondente ao problema encontrado. A maioria dos casos pode ser resolvida revisando configurações como integração, chave OpenAI, créditos, modelos, assistentes, documentos, FAQs, cenários, diretrizes e proteções. Problema 1: Sara não aparece em Configurações Sintoma Você acessa o MEDSAC como administrador, mas não encontra a opção Sara no menu de Configurações. Possíveis causas A Sara pode não aparecer por alguns motivos: - integração ainda não habilitada; - plano sem acesso ao recurso; - permissão insuficiente; - recurso ainda não liberado para a conta; - necessidade de configuração pelo suporte ou time técnico. O que verificar 1. Verifique se a integração está ativa Acesse: Configurações → Integrações Procure pelo card da Sara. Se o card aparecer, mas estiver desativado, ative a integração e atualize a página. 2. Verifique sua permissão Apenas usuários com permissão de Administrador conseguem acessar as configurações da Sara. Se você for atendente, solicite ao administrador da conta que faça a configuração. 3. Verifique o plano da conta A Sara pode depender do plano contratado. Se o card não aparecer ou a opção não estiver disponível, entre em contato com o suporte ou com o responsável comercial. Problema 2: Sara responde com erro genérico Sintoma Ao usar o Copilot ou ao receber uma mensagem do paciente, a Sara retorna erro, não responde ou apresenta uma mensagem como: Erro ao processar O que verificar 1. Chave OpenAI configurada Acesse: Configurações → Sara Procure pela seção da chave OpenAI. Se aparecer uma chave mascarada, como: sk-...abcd a chave está configurada. Se não houver chave configurada, cadastre uma chave OpenAI válida ou solicite apoio ao administrador. 2. Créditos disponíveis Acesse: Configurações → Faturamento Procure pela seção da Sara. Verifique se ainda há créditos disponíveis. Se o limite foi atingido, a Sara pode parar de responder até que novos créditos sejam liberados ou até o próximo ciclo de faturamento. 3. Modelo ativo Acesse: Configurações → Sara Verifique se os modelos configurados estão disponíveis. Se algum modelo estiver indisponível, em teste ou ainda não liberado, troque para um modelo ativo. 4. Validade da chave OpenAI A chave pode ter sido revogada, estar incorreta ou sem saldo disponível na conta OpenAI. Se necessário, gere uma nova chave, salve novamente no MEDSAC e teste. 5. Limite ou instabilidade do provedor Em alguns casos, o provedor de IA pode aplicar limites de uso ou apresentar instabilidade. Se o problema for temporário, aguarde alguns minutos e teste novamente. Problema 3: FAQs não foram geradas após importar documento Sintoma Você importou um documento, mas nenhuma FAQ apareceu para revisão. O que verificar 1. Status do documento Acesse: Configurações → Sara → Assistentes → selecione o assistente → Documentos Verifique o status do documento. Em processamento O documento ainda está sendo processado. Aguarde alguns minutos. Disponível O documento foi processado. Se as FAQs ainda não apareceram, aguarde mais alguns minutos ou tente reprocessar o documento, se essa opção estiver disponível. Erro O documento não foi processado corretamente. Possíveis causas: - URL inacessível; - página fora do ar; - PDF corrompido; - PDF sem texto extraível; - conteúdo vazio; - arquivo muito grande; - bloqueio de acesso ao site. 2. Conteúdo insuficiente Documentos muito curtos ou com pouco conteúdo podem gerar poucas FAQs ou nenhuma FAQ útil. Nesse caso, revise o conteúdo e cadastre informações mais completas. 3. PDF escaneado PDFs escaneados podem não ter texto extraível. Se isso acontecer, transforme o conteúdo em texto com OCR e cadastre como Texto direto. 4. Reimportar o documento Se o documento ficou disponível, mas nada foi gerado após muito tempo, remova o documento e importe novamente. Problema 4: Sara não respeita Diretrizes ou Proteções Sintoma Você configurou uma proteção, mas a Sara continua respondendo de forma inadequada. Exemplo: A proteção diz para não dar diagnóstico, mas a Sara ainda sugere uma possível causa para sintomas. Possíveis causas 1. Regra muito vaga Regras genéricas podem não ser suficientes. Exemplo fraco: Não dê diagnóstico. Exemplo melhor: Quando o paciente descrever sintomas, pedir avaliação médica ou perguntar o que pode ser, não dê diagnóstico, não sugira causa provável, não recomende tratamento e encaminhe para um atendente humano. 2. Conflito com FAQs Se uma FAQ aprovada contém orientação clínica inadequada, a Sara pode usar esse conteúdo. Revise as FAQs aprovadas e remova respostas que possam parecer diagnóstico, prescrição ou orientação de tratamento. 3. Proteção não ativa Verifique se a proteção está cadastrada e ativa no assistente correto. Acesse: Configurações → Sara → Assistentes → selecione o assistente → Configurações → Proteções 4. Cenário com instrução conflitante Um cenário pode conter instruções que conflitam com uma proteção. Revise cenários relacionados ao problema e ajuste as instruções. Problema 5: Cenário não é acionado Sintoma Você criou um cenário, mas a Sara não segue o fluxo esperado. Exemplo: O paciente escreve quero marcar uma consulta, mas a Sara responde normalmente, sem seguir o cenário de agendamento. O que verificar 1. Cenário ativo Acesse a aba Cenários do assistente e confirme se o cenário está ativado. 2. Descrição clara A descrição do cenário precisa explicar claramente quando ele deve ser usado. Exemplo fraco: Atender pacientes. Exemplo melhor: Atender pacientes que querem marcar uma consulta, exame ou retorno na clínica. 3. Cenários parecidos Se houver vários cenários com descrições muito semelhantes, a Sara pode acionar o cenário errado ou não acionar o esperado. Diferencie melhor cada descrição. 4. Teste no Playground Acesse o Playground e teste a frase exata que deveria acionar o cenário. Se não funcionar, ajuste a descrição e teste novamente. Problema 6: Copilot não aparece para o atendente Sintoma O atendente está em uma conversa, mas não vê o ícone da Sara ou o painel Copilot. Possíveis causas 1. Recurso não habilitado O Copilot pode depender de configuração específica. Peça ao administrador para verificar se o recurso está ativo em: Configurações → Sara ou Configurações → Sara → Recursos 2. Caixa de entrada não conectada Dependendo da configuração, o Copilot pode aparecer apenas em conversas de caixas conectadas à Sara. Verifique se a caixa de entrada está vinculada ao assistente correto. 3. Plano sem suporte ao recurso Algumas funções podem depender do plano contratado. Consulte o administrador ou suporte. 4. Problema de carregamento da tela Peça ao atendente para recarregar a página. Se o problema continuar, tente limpar cache do navegador ou acessar novamente. Problema 7: Sara está respondendo muito devagar Sintoma A Sara demora muitos segundos para responder ou o Copilot fica lento. Possíveis causas 1. Modelo muito pesado Modelos mais avançados podem responder mais lentamente. Se a prioridade for velocidade, configure um modelo mais rápido para o recurso afetado. 2. Conversa muito longa Quanto maior o histórico da conversa, mais contexto a Sara pode precisar analisar. Isso pode aumentar o tempo de resposta. 3. Base de conhecimento muito extensa Muitos documentos, FAQs duplicadas ou conteúdos longos podem aumentar o tempo de processamento. Revise a base e remova conteúdos desnecessários. 4. Instabilidade externa O provedor de IA pode estar com lentidão temporária. Nesse caso, aguarde e teste novamente. 5. Rede local Verifique se a internet do usuário está funcionando corretamente. Problema 8: Sara responde informações erradas Sintoma A Sara informa um horário incorreto, convênio desatualizado, endereço errado ou outra informação administrativa incorreta. O que verificar 1. FAQs aprovadas Acesse: Configurações → Sara → Assistentes → selecione o assistente → FAQs Procure a FAQ relacionada ao erro. Edite, corrija ou rejeite a FAQ incorreta. 2. Documentos desatualizados Verifique se o documento de origem está atualizado. Se o conteúdo mudou, atualize ou reimporte o documento. 3. Conteúdos duplicados Documentos ou FAQs duplicadas podem gerar respostas inconsistentes. Mantenha apenas a versão mais correta e atualizada. 4. Diretriz para não inventar informações Se a Sara estiver inferindo informações que não existem na base, adicione uma diretriz orientando que ela responda apenas com base nos documentos e FAQs aprovados. Exemplo: Responda apenas com base nas informações disponíveis nos documentos e FAQs aprovadas. Se não encontrar a informação, encaminhe para um atendente humano. Problema 9: Pacientes receberam mensagens inadequadas Sintoma Um paciente recebeu uma mensagem fora do tom esperado, incorreta, ofensiva, sensível ou inadequada. O que fazer imediatamente 1. Pause a Sara, se necessário Se o erro for grave, pause temporariamente a Sara. Você pode: - desconectar a caixa de entrada do assistente; - desabilitar a Sara em Integrações; - pausar o fluxo conforme a configuração disponível. 2. Localize a conversa Abra a conversa em que o problema ocorreu e leia o histórico. Verifique exatamente o que o paciente enviou e o que a Sara respondeu. 3. Identifique a causa A causa pode estar em: - FAQ incorreta; - documento desatualizado; - proteção fraca; - diretriz mal escrita; - cenário inadequado; - ferramenta configurada incorretamente; - ausência de encaminhamento para humano. 4. Corrija e teste Depois de corrigir, teste no Playground antes de reativar a Sara. 5. Faça atendimento humano Se o paciente foi impactado, um atendente humano deve assumir o caso, esclarecer a situação e conduzir o atendimento com cuidado. Problema 10: Transcrição de áudio não funciona Sintoma O áudio do paciente não foi transcrito ou aparece uma mensagem de erro relacionada à transcrição. Possíveis causas - recurso de transcrição desativado; - créditos insuficientes; - áudio muito longo; - formato de áudio não suportado; - áudio com ruído excessivo; - falha temporária no provedor; - erro de integração. O que verificar Acesse as configurações da Sara e confira se a transcrição de áudio está ativada. Depois, verifique se há créditos disponíveis. Se o áudio for muito longo, peça ao paciente para enviar em partes ou resumir por texto. Se o problema for recorrente, acione o suporte. Problema 11: Sara está encaminhando muitas conversas para humano Sintoma A Sara encaminha quase todas as conversas para a equipe, mesmo perguntas simples. Possíveis causas - proteções muito amplas; - poucos documentos cadastrados; - poucas FAQs aprovadas; - cenários configurados com encaminhamento excessivo; - base de conhecimento incompleta; - diretrizes muito restritivas. Como corrigir Revise as proteções e deixe mais claro quando o encaminhamento deve acontecer. Adicione FAQs para dúvidas administrativas comuns. Revise cenários que estejam encaminhando sem necessidade. Teste novamente no Playground. Problema 12: Sara está respondendo demais sem encaminhar Sintoma A Sara tenta resolver casos que deveriam ir para atendimento humano. Possíveis causas - falta de proteções específicas; - cenários sem instrução de encaminhamento; - diretrizes permitindo respostas amplas demais; - FAQs com conteúdo sensível; - ausência de regra para casos clínicos ou incertos. Como corrigir Adicione proteções claras para: - diagnóstico; - prescrição; - orientação de tratamento; - resultado de exame; - dados sensíveis; - urgência; - reclamações graves; - solicitações médicas. Inclua nos cenários a instrução explícita de encaminhar para humano quando necessário. Problema 13: Sara não responde fora do horário comercial ou responde quando não deveria Sintoma A Sara responde em horários inesperados ou não responde fora do expediente. O que verificar A Sara pode seguir regras de funcionamento conforme a configuração da caixa de entrada. Verifique: - horário regular da caixa; - feriados cadastrados; - exceções; - comportamento fora do expediente; - regras de automação da caixa; - se a Sara deve ou não atuar fora do horário comercial. Acesse: Configurações → Caixas de Entrada → selecione a caixa → Horário de funcionamento Quando contatar o suporte Entre em contato com o suporte se o problema continuar mesmo após revisar as configurações. Ao abrir o chamado, envie o máximo de informações possível. Informações úteis para o suporte Informe: - nome ou ID da conta; - nome da caixa de entrada; - nome do assistente; - descrição clara do problema; - o que era esperado; - o que aconteceu; - quando começou; - se houve alteração recente; - exemplos de mensagens; - prints, se possível; - ID ou link da conversa, quando disponível. Quanto mais detalhes forem enviados, mais rápida tende a ser a análise. Boas práticas para evitar problemas Teste no Playground antes de conectar a Sara a uma caixa real. Comece com uma caixa de baixo volume. Monitore os primeiros atendimentos. Mantenha documentos e FAQs atualizados. Revise diretrizes e proteções periodicamente. Evite cenários duplicados ou muito parecidos. Não aprove FAQs com orientação clínica sensível. Use modelos adequados para cada recurso. Acompanhe consumo de créditos. Oriente os atendentes a reportarem respostas inadequadas. Perguntas frequentes Como faço para começar do zero? Você pode criar um novo assistente e configurar novamente documentos, FAQs, cenários, diretrizes e proteções. Essa costuma ser uma opção mais segura do que apagar tudo do assistente antigo, pois permite comparar os comportamentos antes e depois. Posso ter dois administradores editando a Sara ao mesmo tempo? É possível, mas não é recomendado editar o mesmo assistente ao mesmo tempo. Para evitar conflitos, combine quem ficará responsável por cada parte da configuração. A Sara armazena conversas dos pacientes? As conversas continuam armazenadas no MEDSAC conforme o funcionamento normal das caixas de entrada. Quando a Sara executa ações de IA, parte do conteúdo necessário pode ser enviado ao provedor configurado para processar a solicitação. Por isso, é importante configurar a chave, permissões e políticas conforme as regras da empresa. Como peço uma melhoria na Sara? Registre o caso de uso e envie pelo canal oficial de suporte. Inclua: - qual problema deseja resolver; - qual fluxo seria ideal; - volume aproximado de atendimentos afetados; - exemplos reais; - impacto para a operação. A Sara substitui o suporte técnico? Não. A Sara apoia o atendimento e a automação, mas problemas técnicos, falhas de configuração e integrações devem ser analisados pelo administrador ou suporte. Resumo final A maioria dos problemas com a Sara está relacionada a configuração, chave OpenAI, créditos, modelos, documentos, FAQs, cenários, diretrizes, proteções ou conexão da caixa de entrada. Use este artigo como roteiro de diagnóstico. Se o problema persistir, reúna exemplos, prints, dados da conta e informações da conversa antes de acionar o suporte.

Glossário da Sara: assistente, documento, FAQ, cenário, ferramenta, diretriz e proteção

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 configuração da Sara reúne alguns termos que aparecem com frequência nos artigos e nas telas do MEDSAC. Este glossário explica, de forma rápida, o que significa cada termo. Para entender os detalhes de configuração de cada item, consulte os artigos específicos indicados ao longo do texto. De forma simplificada, a Sara é organizada assim: Sara └── Assistente ├── Documentos ├── FAQs ├── Cenários ├── Ferramentas ├── Diretrizes ├── Proteções └── Caixas de Entrada Assistente O assistente é a configuração principal da Sara. Ele define como a Sara deve atuar, qual será sua finalidade, quais informações ela poderá usar e em quais canais ela poderá atender. Uma conta pode ter um ou mais assistentes, dependendo da necessidade da operação, como recepção, agendamentos, resultados, financeiro ou suporte. Cada assistente pode ter sua própria base de conhecimento, regras, diretrizes e caixas de entrada conectadas. Saiba mais no artigo Criar assistente. Documento Os documentos são fontes de conhecimento usadas pela Sara para responder os pacientes. Eles podem incluir textos internos, páginas de orientação, informações sobre exames, regras de atendimento, documentos de preparo, políticas da empresa e perguntas frequentes. Quanto melhor a base de conhecimento, melhor será a qualidade das respostas da Sara. Saiba mais no artigo Treinar com documentos e FAQs. FAQ As FAQs são perguntas e respostas que ajudam a Sara a responder dúvidas comuns com mais precisão. Elas podem ser geradas a partir dos documentos cadastrados ou criadas manualmente, e ficam disponíveis para consulta depois de revisadas e aprovadas. Exemplos: "Qual o horário de atendimento?", "Quais documentos preciso levar?" ou "O exame precisa de jejum?". Cenário Os cenários são regras ou fluxos que orientam a Sara sobre o que fazer em determinadas situações. Em um cenário, é possível definir quando uma situação deve ser identificada, quais informações a Sara deve coletar e quais ações ela deve executar. Os cenários ajudam a padronizar o atendimento e evitar respostas inadequadas. Saiba mais no artigo Cenários e ferramentas. Ferramenta As ferramentas são ações que a Sara pode executar dentro do MEDSAC. Dependendo da configuração, ela pode aplicar etiquetas, criar notas privadas, encaminhar para um atendente, transferir a conversa, acionar integrações ou consultar informações externas, quando disponível. Diretriz As diretrizes definem como a Sara deve se comportar durante o atendimento. Elas orientam o tom, a linguagem e a estrutura das mensagens, como manter linguagem clara, tom cordial e profissional, pedir informações quando necessário ou encaminhar para um atendente quando não houver segurança. Pense nas diretrizes como regras de comportamento e estilo. Proteção As proteções definem o que a Sara não pode fazer. Em clínicas e laboratórios, isso é essencial para evitar respostas inadequadas sobre temas sensíveis. Por exemplo, a Sara não deve dar diagnóstico, prescrever medicamentos, interpretar resultado de exame, orientar tratamento, substituir avaliação profissional ou expor dados sensíveis sem validação adequada. Pense nas proteções como limites de segurança. Saiba mais sobre os dois últimos termos no artigo Diretrizes e Proteções. Resumo Com uma boa configuração de documentos, FAQs, cenários, ferramentas, diretrizes e proteções, a Sara ajuda a reduzir tarefas repetitivas, organizar conversas e oferecer um atendimento mais ágil, seguro e padronizado.

Permissões e papéis: quem pode configurar e quem pode usar a Sara

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. No MEDSAC, o uso da Sara envolve dois papéis diferentes: quem configura a assistente e quem a usa no dia a dia. Entender essa separação ajuda a organizar a operação, definir responsabilidades e evitar que configurações importantes sejam alteradas por engano. Este artigo explica o que cada papel pode fazer e onde cada um atua dentro da plataforma. Os dois papéis principais | Papel | Quem é | O que faz com a Sara | | ----------------- | ------------------------------- | ---------------------------------------------------------- | | Administrador | Responsável pela configuração | Habilita, configura e mantém a Sara | | Atendente | Quem atende os pacientes | Usa a Sara como apoio durante as conversas | Quem configura a Sara: o administrador As configurações principais da Sara são feitas por usuários com permissão de Administrador na conta. O administrador é responsável por preparar a Sara antes que ela atue no atendimento. Entre as tarefas do administrador estão: - habilitar a integração da Sara na conta; - configurar a chave OpenAI, necessária para gerar respostas e recursos de IA; - criar e ajustar assistentes, definindo nome, descrição e comportamento; - cadastrar a base de conhecimento, com documentos e FAQs; - configurar cenários e ferramentas; - definir diretrizes e proteções de comportamento; - conectar a Sara às caixas de entrada corretas; - acompanhar resultados e revisar configurações com o tempo. Para entender o passo a passo da ativação, consulte o artigo Habilitar Sara. Para criar a configuração central da assistente, consulte Criar assistente. Atendentes não conseguem habilitar, desabilitar ou alterar essas configurações principais. Quem usa a Sara: o atendente No dia a dia, o atendente usa a Sara como ferramenta de apoio durante os atendimentos. A Sara não substitui o julgamento do atendente. Ela ajuda a aumentar a produtividade e a manter um padrão melhor de comunicação. Dependendo dos recursos liberados pelo administrador, o atendente pode contar com a Sara para: - receber sugestões de resposta; - resumir conversas longas; - melhorar, corrigir ou ajustar o tom de um texto digitado; - ler a transcrição automática de áudios; - aplicar etiquetas sugeridas para organizar o atendimento. O detalhamento desses recursos está no artigo Uso diário do atendente. Se algum recurso não aparecer para o atendente, ele pode não estar habilitado na conta. Nesse caso, o atendente deve consultar o administrador. Como os papéis se complementam O administrador prepara a Sara; o atendente a utiliza no atendimento real. Quando o atendente percebe respostas erradas, etiquetas inadequadas ou tom inapropriado, deve reportar ao administrador, que poderá revisar FAQs, documentos, cenários, diretrizes ou proteções. Essa troca contínua mantém a Sara cada vez mais alinhada à operação. Perguntas frequentes Um atendente pode habilitar ou configurar a Sara? Não. A habilitação e a configuração devem ser feitas por usuários com permissão de Administrador. O atendente apenas usa os recursos liberados no atendimento. O atendente precisa da chave OpenAI? Não. A chave é configurada pelo administrador. O atendente apenas utiliza os recursos que dependem dela. Resumo final Existem dois papéis no uso da Sara: o administrador, que habilita e configura assistentes, documentos, diretrizes e a chave; e o atendente, que usa a Sara como apoio nas conversas. Manter essa separação clara ajuda a proteger as configurações e a garantir um atendimento mais organizado e seguro.