Boas Práticas no Envio de Documentos e URLs para a Sophia IA

Como preparar documentos e URLs para que a Sophia IA gere respostas completas, corretas e contextuais nos atendimentos.

A Sophia IA utiliza inteligência artificial generativa para responder às perguntas dos viajantes nos atendimentos. Para que ela ofereça respostas completas, corretas e contextuais, é essencial que os conteúdos fornecidos (documentos e URLs) estejam bem preparados.

Nossa plataforma já possui um questionário completo, que disponibiliza os conteúdos sobre os tópicos mais perguntados na hotelaria. Ainda assim, é importante enviar conteúdos complementares — aqueles que você ainda não informou via questionário e considera relevantes.

Por que isso é importante?

A IA gera suas respostas a partir do material disponibilizado. Se o conteúdo for incompleto, mal redigido ou desorganizado, as respostas tendem a ser superficiais ou confusas.

Por outro lado, um texto claro, estruturado e detalhado permite que a Sophia entregue respostas mais ricas e assertivas — um grande diferencial na experiência do cliente final.

Envio de documentos (docx, pdf e txt)

Ao preparar um documento para enviar à Sophia, siga estas recomendações:

• Qualquer arquivo nos formatos suportados pode ser enviado, mas prefira arquivos com texto corrido (como manuais, FAQs ou guias). Vale reforçar que apenas o texto será enviado para a Sophia; se o arquivo tiver imagens, elas não serão consideradas.
• Use linguagem clara e objetiva, evitando jargões sem explicação.
• Estruture o conteúdo com títulos, subtítulos e listas. Não é mandatório — a IA consegue realizar a leitura corretamente —, mas facilita a compreensão.
• Certifique-se de que o documento está completo, sem páginas ou trechos faltando, e que tenha no máximo 100 MB.

Conteúdos de URLs

• Apenas o texto da página será extraído. Imagens, ícones e elementos visuais não são aproveitados.
• Prefira páginas com conteúdo descritivo e bem escrito, em vez de textos curtos ou fragmentados.
• Verifique se a URL é pública e estável, evitando links temporários ou restritos.
• Se possível, use páginas dedicadas a informações relevantes (institucionais, FAQ online, regulamentos, artigos).
• As informações extraídas correspondem à exata URL disponibilizada. Ou seja, ao extrair o conteúdo do link hotelasksuite.com/spa, apenas essa página terá o conteúdo enviado — e não o site inteiro.
• A extração pode ser pontual (feita uma única vez) ou agendada para ocorrer automaticamente de tempos em tempos, mantendo o conteúdo atualizado conforme o site muda.
• Na extração pontual, as informações não são atualizadas sozinhas: se o conteúdo do site mudar, é preciso atualizar manualmente ou enviar uma nova versão e excluir a anterior. Na agendada, a atualização acontece automaticamente na periodicidade definida. Saiba mais em Como configurar atualização automática para conteúdos extraídos por URL.

Como estruturar um bom conteúdo

As práticas abaixo valem para qualquer documento que você enviar. Elas ajudam a Sophia a identificar o tema, entender o contexto e recuperar as informações corretas.

1. Organização do conteúdo em blocos

O conteúdo deve ser estruturado em blocos claros para facilitar a leitura e a interpretação pela Sophia. A organização ajuda a IA a identificar rapidamente o tema, entender o contexto e recuperar as informações corretas.

Estruture sempre o conteúdo com:

• Título / Tema
• Descrição
• Listas (quando aplicável)
• Quebras de linha para separar informações

Evite textos longos e contínuos. Prefira dividir as informações de forma visualmente organizada.

Exemplo:

PACOTE FERIADO DIA DO TRABALHADOR

Descrição:
Pacote especial para o feriado, ideal para quem busca descanso,
exclusividade e contato com a natureza. A experiência é voltada
para tranquilidade, conforto e bem-estar.

Inclui:
- Café da manhã
- Welcome drink no check-in
- Aula de yoga no sábado pela manhã
- Sunset com música ao vivo no sábado à tarde

Condições:
- Mínimo de 2 noites
- 1 garrafa de espumante no quarto

2. Separação por tópicos

Separe as informações por tópicos sempre que houver mais de um tipo de conteúdo no mesmo documento. Isso evita confusão, melhora a leitura e ajuda a Sophia a identificar exatamente qual informação usar na resposta.

Evite agrupar tudo em um único bloco de texto. Sempre que possível, organize por categorias claras, como: Programação, Inclusões, Condições, Benefícios, Regras. Isso é essencial principalmente quando o conteúdo envolve múltiplas informações operacionais.

✕ Forma incorreta

Um fim de semana para desacelerar entre o verde e o mar, com jantar
saudável, yoga, sunset, programação de sexta a domingo com atividades,
prática de yoga, meditação, jantar, café da manhã, check-out às 12h,
inclui espumante no quarto, mínimo de 2 noites, opção de meia pensão
ou pensão completa e evento exclusivo para hóspedes.

✓ Forma correta

PACOTE YOGA, SUNSET E BEM-ESTAR

Descrição:
Experiência de fim de semana voltada ao bem-estar, com atividades como
yoga, meditação e alimentação saudável, em um ambiente exclusivo.

Programação:

Sexta-feira:
- Abertura do evento
- Jantar com menu saudável

Sábado:
- Café da manhã
- Aula de yoga
- Roda de conversa sobre a prática
- Sucos detox
- Meditação no deck
- Sunset com sax e lanche saudável
- Jantar com menu saudável

Domingo:
- Aula de yoga de encerramento
- Check-out às 12h

Benefícios:
- 1 garrafa de espumante no quarto

Condições:
- Mínimo de 2 noites
- Opção de meia pensão ou pensão completa
- Evento exclusivo para hóspedes
- Programação sujeita a alteração

3. Nomear itens de forma distinta e clara

A nomeação dos conteúdos deve ser clara, específica e consistente. Nomes genéricos ou muito parecidos podem gerar ambiguidade, dificultando a interpretação da Sophia e resultando em respostas imprecisas ou incorretas.

Sempre que houver conteúdos semelhantes, explicite as diferenças tanto no nome quanto na descrição. A Sophia depende dessas distinções para comparar, identificar e responder corretamente às perguntas dos viajantes.

O que fazer

• Usar nomes completos e descritivos
• Incluir diferenciais claros (ex.: parcial, frontal, premium, categoria, localização)
• Manter um padrão consistente entre conteúdos semelhantes
• Garantir que a descrição reforce a diferença entre os itens

O que evitar

• Nomes genéricos ou vagos
• Variações de nome que parecem diferentes, mas significam a mesma coisa
• Falta de padronização
• Conteúdos semelhantes sem explicação clara da diferença

✕ Forma incorreta

Quarto Vista Mar
Quarto Vista para o Mar
Quarto com Vista Mar

Descrição:
Quartos com vista para o mar, com conforto e ótima localização.

Problema: os nomes parecem diferentes, mas não deixam claro se existem variações reais. A Sophia não consegue identificar diferenças e tende a responder de forma genérica — por exemplo: “Todos os quartos com vista para o mar possuem características similares.”

✓ Forma correta

QUARTO VISTA MAR PARCIAL
Quarto com vista lateral para o mar.

QUARTO VISTA MAR FRONTAL
Quarto com vista direta para o mar.

QUARTO VISTA MAR PREMIUM
Quarto com vista panorâmica e maior metragem.

Pergunta do viajante: “Qual a diferença entre os quartos com vista para o mar?”

Resposta esperada: “A diferença está no tipo de vista e categoria — Vista Mar Parcial (vista lateral), Vista Mar Frontal (vista direta) e Vista Mar Premium (vista panorâmica e maior conforto).”

4. FAQ (Perguntas e Respostas)

Incluir perguntas e respostas ajuda a Sophia a compreender melhor as intenções dos viajantes e aumenta a precisão das respostas. O FAQ funciona como um reforço prático do conteúdo, simulando dúvidas reais.

As perguntas devem ser

• Diretas e objetivas
• Relacionadas ao conteúdo do documento
• Escritas como o cliente perguntaria

As respostas devem ser

• Claras e completas
• Baseadas apenas no conteúdo apresentado
• Sem adicionar comportamento ou instruções para a IA

Evite usar o FAQ para definir regras de atendimento ou comportamento da Sophia. O foco deve ser apenas o conteúdo.

Exemplo:

PROGRAMA DE FIDELIDADE COM CASHBACK

Perguntas frequentes:

O que é o programa de fidelidade?
É um programa que oferece vantagens exclusivas para hóspedes que
realizam reservas diretamente pelo site, como cashback e descontos.

Como funciona o cashback?
Ao se cadastrar e realizar uma reserva pelo site, o hóspede recebe
5% de cashback sobre o valor total das diárias, para uso em uma
próxima hospedagem.

Como faço para garantir o cashback?
É necessário se cadastrar no programa de fidelidade e concluir a
validação enviada por e-mail após a reserva.

Quando o crédito fica disponível?
O crédito fica disponível 5 dias após a data do check-out.

Onde posso usar o crédito?
O crédito pode ser utilizado em uma próxima reserva.

O cashback é válido para qualquer reserva?
Não, é válido exclusivamente para reservas realizadas pelo site oficial.

Limites de conteúdo

Existem dois limites importantes a considerar: o tamanho de cada documento e a quantidade de documentos consultados a cada pergunta.

Limite por documento

A Sophia possui um limite de processamento por conteúdo. Para garantir melhor desempenho e evitar perda de informação, mantenha os textos dentro de um tamanho adequado.

Recomendação: até aproximadamente 1.000 tokens, o equivalente a cerca de 4.000 caracteres ou 700 palavras.

Conteúdos muito longos podem ser parcialmente ignorados, perder informações relevantes ou gerar respostas incompletas. Sempre que o conteúdo for extenso, ele deve ser dividido em partes menores, organizadas por tema.

Limite de documentos consultados por assunto

O ponto é encontrar o equilíbrio entre dividir e consolidar:

• Divida em vários documentos quando o conteúdo for muito longo, separando por tema, contexto ou categoria (respeitando o limite de tamanho acima).
• Não crie vários documentos diferentes tratando do mesmo assunto. Consolide informações relacionadas em um único conteúdo bem estruturado.
• Procure fazer com que cada documento seja autossuficiente sobre o seu subtema, para que uma resposta não dependa de reunir muitos documentos ao mesmo tempo.
• Use nomes distintos e claros (veja a seção “Nomear itens de forma distinta e clara”, mais acima) apenas para diferenciar os conteúdos que realmente são diferentes.

O que fazer

• Manter conteúdos curtos e objetivos
• Dividir conteúdos grandes em múltiplos documentos, por tema
• Consolidar conteúdos repetidos sobre o mesmo tema
• Priorizar as informações mais relevantes

O que evitar

• Criar documentos muito longos
• Criar vários documentos quase idênticos sobre o mesmo assunto
• Misturar múltiplos assuntos para “aproveitar espaço”
• Ignorar o limite de tokens

Automações por tema

A automação por tema permite definir instruções específicas que orientam o comportamento da Sophia com base em um assunto identificado na conversa. Funciona como um “prompt controlado”, indicando quando e como a Sophia deve responder. Diferente das frases gatilho, não depende de uma frase exata: a Sophia identifica o contexto da conversa e aplica a instrução definida.

Saiba mais em Automação de etiquetas e respostas por Temas.

Restrições e boas práticas técnicas

Os pontos abaixo não são bloqueios absolutos, mas impactam diretamente a leitura e a interpretação da IA.

Formato (Markdown e HTML)

• Não é obrigatório utilizar Markdown.
• O conteúdo pode ser inserido em texto puro normalmente.
• HTML é permitido, porém pode conter código desnecessário (“lixo”) e prejudicar a leitura da IA se estiver desorganizado.

Instruções dentro do conteúdo

• A base de conhecimento não deve conter instruções de comportamento da IA.
• Conteúdos devem ser apenas informativos.
• Instruções devem ser configuradas separadamente (ex.: automação por tema).

Interpretação de conteúdo estruturado

Conteúdos com excesso de marcação (HTML ou formatação complexa) podem dificultar a leitura e gerar interpretações incorretas.

✕ Exemplo de HTML desorganizado

<div><span><b>Pacote especial</b></span></div>
<div><span>Inclui café da manhã</span></div>
<div><span><i>Regras misturadas com instruções:</i></span></div>
<div><span>Quando o cliente pedir desconto, enviar link X</span></div>

Problema: código desnecessário, mistura de conteúdo com instrução e dificuldade de interpretação pela Sophia.

Template modelo completo

Abaixo está um modelo padrão pronto para uso na base de conhecimento da Sophia. Ele segue todas as boas práticas apresentadas: organização em blocos, separação por tópicos, clareza, limite de conteúdo e uso de FAQ. Pode ser usado como base para criar novos conteúdos.

Modelo em branco (para preencher)

[Título / Tema]
Descreva um nome claro, específico e completo para o conteúdo.

[Descrição]
Escreva um resumo objetivo explicando o que é o conteúdo, para quem
é e qual a proposta.

[Listas e Separação por Tópicos]
Organize as informações em blocos claros, utilizando listas e
quebras de linha.
Exemplo de estrutura:
- Programação (se aplicável)
- Inclui
- Benefícios
- Condições
- Perfil do produto

[FAQ - Perguntas frequentes]
Adicione perguntas e respostas com base nas dúvidas reais do cliente.
As perguntas devem ser diretas e as respostas objetivas.

[Automação por Tema - opcional]
Defina uma instrução curta e específica indicando quando e como a
Sophia deve responder sobre este conteúdo. Lembre-se: essa instrução
é configurada na automação por tema, não dentro do documento.
Evite instruções genéricas.

Dica de ouro

Pense sempre: “Se eu fosse responder ao cliente, esse conteúdo me daria todas as informações necessárias?” Se a resposta for sim, é um bom indicativo de que a Sophia IA conseguirá gerar respostas completas, confiáveis e diferenciadas.