Quais formatos de conteúdo podem ser usados na base de conhecimento?
- .doc
- .docx
- .pptx
- .txt
- .md
- URLs (não podem estar protegidas por senha)
O que significa recuperação em tempo real?
O agente pesquisa ativamente o seu domínio a cada conversa — sem necessidade de reindexação. Isso é diferente dos arquivos enviados, que são indexados no momento do envio e consultados quando um usuário faz uma pergunta relevante.
Existem boas práticas para o envio de documentos à base de conhecimento?
- Divida PDFs grandes (com mais de 50 páginas) para obter uma indexação mais rápida.
- Aguarde até que o status do arquivo mostreProcessadoantes de fechar a janela ou navegar para outra página. Não alterne entre abas durante o envio.
- Não feche nem atualize o editor enquanto os arquivos estiverem sendo enviados — se a sua sessão expirar, até os tipos de arquivo compatíveis podem exibir um erro de formato não suportado. Se isso acontecer, atualize a página e envie o arquivo novamente.
- URLs adicionadas como fontes de conhecimento precisam ser acessíveis publicamente. Páginas protegidas por senha, com restrição geográfica ou protegidas pelo Cloudflare podem não ser indexadas corretamente. ConsulteLimitações da Análise do Websitepara mais detalhes.
Os arquivos .txt e .md são realmente compatíveis? Estou sempre recebendo um erro.
Sim, tanto .txt quanto .md são compatíveis. Se você vir um erro de formato não suportado para esses tipos, sua sessão de edição provavelmente expirou. Atualize a página e tente enviar novamente.
Observação: os arquivos .md funcionam melhor como fontes da base de conhecimento quando contêm conteúdo de referência factual. Se o seu arquivo .md se assemelhar mais a instruções ou a uma descrição de persona, considere colar esse conteúdo diretamente no editor de Persona Prompt — ele terá uma influência mais direta sobre o comportamento do agente.
Meu agente está dando respostas incompletas ou incorretas, mesmo depois de eu ter enviado os documentos certos. O que devo verificar?
A causa mais comum de respostas pouco confiáveis a partir de documentos enviados é aestrutura do arquivo de origem. A base de conhecimento utiliza embeddings de IA para entender e recuperar conteúdo, e alguns formatos de documento carregam muito pouco significado semântico para esse processo.
Evite enviar diretamente estes tipos de documento:
- Impressões de planilhas ou dados tabulares(por exemplo, um PDF exportado do Excel com linhas e colunas de sessões de eventos, listas de produtos ou agendas). Layouts tabulares não têm estrutura de frase suficiente para que o modelo de embeddings responda de forma confiável a perguntas como "Liste todas as sessões do palestrante X" ou "A que horas é o intervalo para o almoço?" — ele pode pular itens ou dar respostas incorretas.
- Documentos digitalizados ou PDFs baseados em imagem— eles não contêm texto legível e não serão indexados corretamente.
- Documentos com formatação pesada, com layouts complexos, várias colunas ou tabelas densas — eles costumam gerar conteúdo indexado fragmentado ou fora de ordem.
O que fazer em vez disso:
- Converta dados tabulares emtexto narrativo, em forma de frases. Por exemplo, em vez de uma linha de tabela como "Florian Rotberg | Sessão 3 | 14h | Hall B", escreva: "Florian Rotberg apresenta a Sessão 3 às 14h, no Hall B." Esse formato é muito mais fácil de recuperar com precisão.
- Para agendas e dados estruturados com muitas entradas, considere dividir o conteúdo em documentos menores, separados por categoria (por exemplo, um documento por palestrante ou um documento por dia), em vez de um único arquivo combinado.
- Adicione uma FAQ dedicada para as perguntas mais importantes que sempre precisam ser respondidas corretamente — as entradas de FAQ têm prioridade sobre a recuperação da base de conhecimento.
No meu painel do Spaces, todos os meus Spaces apareceram como excluídos depois de um erro de envio. O que aconteceu?
Isso é um problema de exibição da sessão, não uma perda de dados. Atualize a página e seus Spaces vão reaparecer.