Adicionar um site público como fonte de conhecimento

Ao adicionar sites públicos como fontes de conhecimento no nível do agente, você usa informações disponíveis publicamente para melhorar o alcance do seu agente.

Adicionar um site público

Para adicionar um site público como uma fonte de conhecimento, conclua as seguintes etapas:

1. Abra o agente.

2. Selecione Adicionar conhecimento das páginas Visão geral ou Conhecimento ou nas Propriedades de um nó de respostas generativas.

3. Selecione Sites públicos.

4. Insira a URL para o site público. Para usar uma variável em vez de uma URL estática, selecione o ícone do seletor de variável ao lado do campo URL e escolha uma variável Personalizada, Sistema ou Ambiente .

5. Adicione um nome (por padrão, a URL do site é usada).

6. Adicione uma descrição. Forneça uma descrição detalhada, especialmente se a IA generativa estiver habilitada, pois a descrição auxiliará a orquestração generativa.

7. Selecione Adicionar ao agente para concluir a adição da fonte de conhecimento.

8. Teste seu agente para ver o quão bem ele responde a perguntas relacionadas ao conteúdo do seu site. Convém testar perguntas de caso extremo para decidir se você precisa de uma moderação inferior para ser mais inclusivo.

Considerações do URL

A URL que você usa em seu agente representa o escopo do conteúdo para gerar respostas. Algumas URLs têm requisitos e restrições.

Tipo e estrutura de URL

• A URL pode ter até dois níveis de profundidade com subcaminhos indicados uma barra /. No entanto, uma barra à direita é permitida.

  Válido	Não válido
  www.contoso.com www.fabrikam.com/engines/rotary www.fabrikam.com/engines/rotary/	www.fabrikam.com/engines/rotary/dual-shaft

• Se a URL for redirecionada para outro site de nível superior, o conteúdo não será incluído em resultados:

  Por exemplo, se www.fabrikam.com redirecionar para www.contoso.fabrikam.com, seu agente não gerará respostas de conteúdo em nenhum desses URLs.

• Não há suporte para URLs que apontam para um site que exige autenticação ou não indexadas pelo Bing.

  Por exemplo, wikis e sites SharePoint exigem autenticação, portanto, você não pode usá-los:

  • fabrikam.visualstudio.com/project/_wiki
  • fabrikam.sharepoint.com

Estrutura de domínio da URL

Seu agente usa qualquer conteúdo visualizável publicamente na URL especificada, incluindo subdomínios em um domínio de nível superior, para gerar conteúdo.

Exemplos:

• Se você usar www.fabrikam.com/engines/rotary, o agente também usará o conteúdo www.fabrikam.com/engines/rotary/dual-shaft para gerar respostas.

  O agente não usa conteúdo em www.fabrikam.com/tools, uma vez que ferramentas não é um subdomínio de rotary.

• Se você usar www.fabrikam.com (o www existe), o agente não usará conteúdo em news.fabrikam.com (o www não existe), pois a notícia é um subdomínio no domínio de nível superior fabrikam.com.

• Se você usar fabrikam.com, o agente utilizará conteúdo em www.fabrikam.com e em news.fabrikam.com, já que estão sob o domínio raiz fabrikam.com.

URLs de redes sociais e fóruns

Seu agente pode gerar respostas absurdas, irrelevantes ou inadequadas se você usar um fórum ou site de rede social como URL. Portanto, o conteúdo de comunidades nas redes sociais muitas vezes aumenta o risco de mais respostas serem rejeitadas.

Para obter mais informações, consulte as Perguntas frequentes sobre respostas generativas. A IA é treinada para evitar a geração de respostas mal-intencionadas e ofensivas.

URLs do mecanismo de pesquisa

Não inclua URLs de mecanismos de pesquisa como bing.com, pois elas não dão respostas úteis.

Usar variáveis como URLs

Use variáveis em URLs de fontes de conhecimento do site público ou do SharePoint para controlar dinamicamente o escopo do conteúdo que seu agente utiliza.

Em vez de criar várias fontes de conhecimento para cenários diferentes, defina uma única fonte de conhecimento e insira uma variável na URL. Em tempo de execução, o Copilot Studio resolve a variável e usa a URL resultante para fundamentação.

Suporte a variáveis

Ao adicionar ou editar uma URL de site público ou uma fonte de conhecimento do SharePoint, você pode inserir uma variável no campo de URL.

Use uma variável para:

• Acrescentar um caminho a uma URL base

  https://www.contoso.com/{variable}

• Substituir a URL inteira

  {variable}

Em runtime, a variável é resolvida para um valor de cadeia de caracteres. A fonte de conhecimento é delimitada pela URL resolvida.

Criar e definir uma variável

Para usar uma variável em um site público ou em uma fonte de conhecimento do SharePoint:

1. Crie uma variável de cadeia de caracteres com escopo global .

2. Defina o valor da variável usando uma das seguintes opções:

   • Entradas de tópico
   • Propriedades de perfil do usuário, como idioma
   • Variáveis de ambiente
   • Fluxos ou conectores do agente

3. Insira a variável no campo URL selecionando {x} (inserir variável).

4. Teste o agente para confirmar que a variável resulta na URL esperada.

Exemplo: Escopo por produto

Você pode definir o escopo do conhecimento para diferentes áreas do produto com base na consulta do usuário.

1. Use uma entrada de tópico para capturar o nome do produto como uma variável chamada Product.

2. Adicione um nó Definir valor de variável após o nó Gatilho e crie uma nova variável chamada ProductTable.

3. Use uma fórmula do Power Fx para definir e mapear os nomes dos produtos para caminhos de URL.

    Table(
        { Product: "Copilot", Path: "microsoft-365-copilot" },
        { Product: "Teams", Path: "microsoft-teams" },
        { Product: "Surface", Path: "surface" }
    )
   

4. Adicione outro nó Definir valor de variável e use-o para criar uma nova variável global do tipo de cadeia de caracteres chamada GlobalProductURL.

5. Na configuração Para valor, selecione Fórmula e use uma função do Power Fx para executar uma pesquisa na tabela com base no valor da variável de entrada Product, Topic.Product, da seguinte maneira:

   LookUp(Topic.ProductTable, Product = Topic.Product, Path)

6. Use a variável na URL da fonte de dados de conhecimento:

   https://www.microsoft.com/en-us/{GlobalProductURL}

O agente consulta apenas a seção com escopo do site no runtime.

Cenários comuns

Use variáveis em fontes de conhecimento do site público para:

• Roteamento baseado em produto: direcione consultas para a documentação específica do produto.

• Filtragem de região ou idioma: mapear User.Language para URLs localizadas (por exemplo, en-us, ). it-it

• URLs específicas do ambiente: alternar entre sites de desenvolvimento, teste e produção.

Considerações

• As fontes de conhecimento do site público usam a pesquisa do Bing e dependem do conteúdo indexado.
• Os limites de profundidade de URL ainda se aplicam quando você usa variáveis.
• As variáveis alteram apenas a URL de destino. Eles não afetam a forma como o conteúdo é indexado ou recuperado.