← Přehled / ai-search / how-to

NLWeb

Povolte konverzační vyhledávání na svém webu pomocí NLWeb a Cloudflare AI Search. Tato šablona prochází váš web, indexuje jeho obsah a nasazuje standardní endpointy NLWeb, které slouží lidem i AI agentům.

NLWeb ↗ je otevřený projekt vyvinutý společností Microsoft, který definuje standardní protokol pro dotazování webů v přirozeném jazyce. Jeho cílem je, aby byl každý web stejně přístupný a interaktivní jako konverzační AI aplikace, takže lidé i AI agenti mohou spolehlivě dotazovat obsah webu. Toho dosahuje tím, že zpřístupňuje dva klíčové endpointy:

• /ask: Konverzační endpoint pro uživatelské dotazy
• /mcp: Strukturovaný endpoint Model Context Protocol (MCP) pro AI agenty

NLWeb můžete na svém webu nasadit přímo prostřednictvím dashboardu AI Search:

1. Přihlaste se ke svému Cloudflare dashboard ↗.

2. Přejděte na AI > AI Search.

   Přejděte na AI Search ↗

3. Vyberte Vytvořte AI Search.

4. Vyberte Web jako zdroj dat.

5. Postupujte podle pokynů a vytvořte instanci AI Search.

6. Přejděte na Nastavení pro instanci

7. Najděte NLWeb Worker a vyberte možnost "Enable AI Search for your website".

Po dokončení AI Search nasadí NLWeb Worker, který vám umožní používat endpointy NLWeb API.

Výběr možnosti NLWeb Website rozšiřuje běžné AI Search o přizpůsobení webům s velkým množstvím obsahu a poskytuje vše potřebné k tomu, abyste mohli NLWeb zavést jako standard pro konverzační vyhledávání na svém webu. Konkrétně tato šablona poskytuje:

• Web jako zdroj dat: Používá Web jako možnost zdroje dat pro procházení a načítání stránek pomocí možnosti Rendered Sites.
• Výchozí hodnoty pro weby s velkým množstvím obsahu: Používá vyladěné konfigurace embeddingu a vyhledávání, ideální pro publikační weby s bohatým obsahem.
• Nasazení NLWeb Workeru: Automaticky spustí Cloudflare Worker z Šablona NLWeb Workeru ↗.

Nasazený Worker poskytuje dva endpointy:

• /ask: Standardní konverzační endpoint NLWeb
  • Pohání konverzační rozhraní na kořenové adrese (/)
  • Pohání vložitelný widget náhledu (/snippet.html)
• /mcp: MCP server endpoint NLWeb pro důvěryhodné AI agenty

Tyto endpointy poskytují lidem i agentům strukturovaný přístup k vašemu obsahu.

Vložitelný úryvek můžete použít k přidání vyhledávacího uživatelského rozhraní přímo do svého webu. Například:

<!-- Add css on head -->
<link rel="stylesheet" href="https://ask.example.com/nlweb-dropdown-chat.css" />
<link rel="stylesheet" href="https://ask.example.com/common-chat-styles.css" />

<!-- Add container on body -->
<div id="docs-search-container"></div>

<!-- Include JavaScript -->
<script type="module">
	import { NLWebDropdownChat } from "https://ask.example.com/nlweb-dropdown-chat.js";

	const chat = new NLWebDropdownChat({
		containerId: "docs-search-container",
		site: "https://ask.example.com",
		placeholder: "Search for docs...",
		endpoint: "https://ask.example.com",
	});
</script>

Díky tomu můžete konverzační AI vyhledávání poskytovat přímo z vlastní domény a mít pod kontrolou, jak k vašemu obsahu přistupují lidé i agenti.

Worker můžete chtít upravit, například kvůli přizpůsobení uživatelského rozhraní vložitelného úryvku. V takových případech doporučujeme volat /ask koncový bod pro dotazy a vytvoření vlastního uživatelského rozhraní nad ním. Kód Workeru pro vložitelné uživatelské rozhraní však můžete také upravit.

Pokud dojde k aktualizaci standardu NLWeb, můžete aktualizovat svůj Worker, aby zůstal kompatibilní a získal nejnovější vylepšení.

Nejjednodušší způsob, jak použít změny nebo aktualizace, je znovu nasadit šablonu Workeru:

1. Použijte Deploy to Cloudflare výše, čímž nasadíte šablonu Workeru do vašeho účtu Cloudflare.
2. Zadejte název své instance AI Search do RAG_ID pole proměnné prostředí.
3. Klikněte na Nasadit.
4. Vyberte GitHub/GitLab ikonu na dashboardu Workers.
5. Naklonujte repozitář, který byl vytvořen pro váš Worker.
6. Proveďte úpravy, poté odešlete commit se změnami do repozitáře, čímž aktualizujete svého Workera.

Nyní můžete tento Worker použít jako nový endpoint NLWeb pro svůj web.