Fontes externas para busca assistida por IA

Fontes externas para Busca Assistiva Eddy AI permitem configurar o Eddy AI para recuperar respostas de URLs e sitemaps fora da sua base de conhecimento Document360, possibilitando busca federada em múltiplas fontes de conteúdo. Uma vez configurado, o Eddy AI pesquisa simultaneamente tanto os artigos da sua base de conhecimento interna quanto as fontes externas, retornando uma resposta unificada com referências numeradas que remetem à página de origem. Isso está disponível na seção Gerenciar fontes , na seção de recursos de IA no seu portal da Base de Conhecimento.

Quando usar fontes externas

• Equipes de suporte multiplataforma — os agentes podem extrair respostas de artigos de base de conhecimento interna, sites públicos de documentação, blogs e notas de lançamento de produtos sem precisar trocar de plataforma.
• Conteúdo distribuído — quando seu conteúdo autoritativo está presente em vários sites e você quer que a Eddy AI apresente respostas de todos eles em uma única resposta.
• Material de referência suplementar — adicione recursos externos, como guias de terceiros ou documentação de parceiros, para enriquecer as respostas da Eddy AI sem migrar esse conteúdo para o Document360.

Antes de começar

• Você pode adicionar até 50 páginas web e 1 sitemap por projeto.
• As páginas devem estar no formato HTML5 e incluir <article> tags de ouro <main> .
• Apenas páginas web renderizadas do lado do servidor (SSR ) são suportadas. Páginas renderizadas do lado do cliente podem não indexar corretamente e podem devolver resultados de busca vazios.
• Páginas web com mecanismos de detecção de bots ou bloqueio de rastreamento não podem ser indexadas — um erro proibido ocorrerá.
• Sitemaps devem ter menos de 1 MB, em formato XML, e não devem usar sitemaps aninhados com a <sitemapindex> tag.
• As fontes sincronizam automaticamente a cada 24 horas. A sincronização manual está disponível até 4 vezes por dia.

Como adicionar uma fonte externa

1. No portal da Base de Conhecimento, selecione Configurações na barra de navegação da esquerda.

2. No painel de navegação à esquerda, vá para recursos de IA > Gerenciar fontes.

   A página Gerenciar fontes exibe todas as fontes externas configuradas atualmente.

3. Clique em Adicionar novo.

   O painel Adicionar fonte aparece.

4. Selecione o tipo de fonte: Página Web ou Sitemap.

5. Insira o nome da fonte.

6. Insira uma URL válida.

7. Clique em Adicionar fonte.

Visão geral do gerenciar fontes

A página Gerenciar fontes lista todas as fontes externas indexadas e fornece os seguintes controles:

Como restringir o Eddy AI a espaços de trabalho, linguagens e categorias específicas

Por padrão, o Eddy AI pesquisa em todos os espaços de trabalho e idiomas. Você pode restringir isso a espaços de trabalho, idiomas e categorias específicas usando o controle de acesso ao conteúdo na página Gerenciar fontes.

1. Na página Gerenciar fontes , clique no menu suspenso de acesso ao conteúdo (mostrado como Todos por padrão).

2. Selecione Permitir selecionado.

   O popup Gerenciar espaço de trabalho e categoria aparece.

3. Selecione os espaços de trabalho, idiomas e categorias que você quer que a Eddy AI pesquise.

   Um botão Gerenciar aparece ao lado do menu suspenso Permitir selecionado .

4. Clique em Gerenciar para revisar e confirmar suas seleções, depois clique em Salvar.

   Uma mensagem de confirmação — fontes de busca por IA atualizadas — aparece. O botão Salvar só é ativado quando alterações foram feitas.

5. Para fechar o pop-up sem salvar, clique em Cancelar ou pressione Esc.

Como lidar com erros em fontes externas

Se uma página encontrar um erro (formato HTML não suportado, linguagem não suportada ou problema com HTTPS), a Eddy AI para de buscar a página até que o erro seja resolvido. Para sitemaps, o Eddy AI continua buscando de todas as URLs válidas no sitemap, mesmo que as páginas individuais dele tenham erros.

1. Clique no ícone Erro (⚠) ao lado do interruptor de status da fonte.

   O painel de Edição se abre e exibe todas as URLs afetadas e seus detalhes de erro.

2. Passe o mouse sobre uma URL e clique no ícone Abrir site para inspecionar diretamente a fonte externa.

3. Clique em Remover para deletar uma URL específica da lista de URLs do sitemap.

4. Clique em Remover todos para apagar todas as URLs com erros de uma vez.

Como aparecem os resultados de fontes externas no seu site da Base de Conhecimento

Quando a Eddy AI retorna uma resposta que vem de fontes externas:

• Cada resposta inclui marcadores de referência numerados que indicam quais partes da resposta vieram de qual fonte.
• Ao passar o mouse sobre um número de referência, aparece o título da página e uma breve descrição da fonte.
• Clicar no número de referência ou no ícone Abrir em uma nova aba abre a página de origem em uma nova aba.

Solução de problemas

Erro de formato não suportado ao adicionar um sitemap

Mensagem de erro: Unsupported format

Esse erro ocorre quando o sitemap contém sitemaps aninhados usando a <sitemapindex> tag, ultrapassa 1 MB de tamanho de arquivo ou não está em um formato suportado.

Para resolver:

• Use apenas uma URL direta do sitemap — sitemaps aninhados com <sitemapindex> não são suportados.
• Certifique-se de que o arquivo do sitemap tenha menos de 1 MB.
• Verifique se o sitemap está em formato XML.

Erro proibido ao adicionar uma página web

Mensagem de erro: Forbidden

Esse erro ocorre quando a página possui mecanismos de detecção de bots ou outros mecanismos de rastreamento que impedem a Eddy AI de acessar o conteúdo.

Para resolver:

• Verifique se a URL de origem tem a detecção de bots ativada. Se sim, entre em contato com o administrador do site para permitir o acesso do crawler.
• Use uma URL de origem diferente que não restrinja o rastreamento.

Erro de formato HTML5 ao adicionar uma página web

Mensagem de erro: Only HTML5 documents with <article> or <main> tags

Esse erro ocorre quando a página da web não está no formato HTML5 ou não contém as tags obrigatórias <article> ou <main> (required).

Para resolver:

• Verifique o doctype HTML5 — a página deve declarar <!DOCTYPE html> no topo.
• Verifique as tags necessárias — veja a fonte da página (Ctrl+U / Cmd+U) e confirme se a página contém <article> ou <main> as tags.
• Atualize a página — se qualquer um dos requisitos não for atendido, atualize a página para se conformar antes de adicioná-la como fonte.

Erro de idioma não suportado ao adicionar uma página web

Mensagem de erro: Error due to unsupported language

Esse erro ocorre quando o Eddy AI não suporta o idioma da página web, ou quando o idioma é suportado mas não foi adicionado às configurações de localização do seu projeto.

Para resolver:

1. Verifique se o idioma da página web é suportado pela Eddy AI — veja Suporte multilíngue para o Eddy AI Search Suite.
2. Se a linguagem for suportada, certifique-se de que ela seja adicionada ao seu projeto. Por exemplo, se você estiver adicionando https://abc.document360.com/fr/document:
   1. No portal da Base de Conhecimento, selecione Configurações na barra de navegação da esquerda.
   2. No painel de navegação à esquerda, vá ao portal da Base de Conhecimento > Localização e Espaços de Trabalho.
   3. Confirme que o francês (fr) está disponível no espaço de trabalho selecionado.
3. Se o problema persistir, entre em contato com o suporte do Document360.

FAQ