← Přehled / ai-search / configuration / retrieval

Nastavení veřejného koncového bodu

Nakonfigurujte veřejné endpointy, které zpřístupní vaši instanci AI Search přímo uživatelům bez nutnosti ověření. Díky tomu můžete funkce AI Search sdílet s externími uživateli nebo je integrovat do veřejně dostupných aplikací.

Veřejný endpoint můžete povolit pro jednu instanci nebo pro celý namespace, který prohledává více instancí najednou a slučuje výsledky. Vše na této stránce platí pro oba případy. Informace specifické pro jmenné prostory, například jak zvolit, ke kterým instancím má endpoint přístup, najdete v Veřejné endpointy jmenného prostoru.

Instance nebo jmenný prostor mohou zpřístupnit tři veřejné endpointy:

Podrobnosti o použití těchto koncových bodů najdete v Používání veřejného koncového bodu.

Hostitelský název generuje Cloudflare při povolení endpointu. Nejedná se o název instance ani jmenného prostoru.

Například:

• https://abc123.search.ai.cloudflare.com/search
• https://ns-abc123.search.ai.cloudflare.com/search

Identifikátor se vygeneruje při prvním povolení endpointu a nikdy se nemění. Po zakázání endpointu identifikátor zůstává zachován, takže jeho opětovné povolení znovu použije stejnou URL adresu.

Stejné endpointy můžete zpřístupnit také z hostitelského názvu, který vlastníte, například https://search.example.com/search. Viz Vlastní domény.

Každý veřejný endpoint můžete povolit nebo zakázat samostatně:

1. Přihlaste se do svého účtu Cloudflare a přejděte na AI Search. Přejděte na AI Search ↗
2. Vyberte svou instanci nebo jmenný prostor AI Search.
3. Přejděte na Nastavení > Veřejné koncové body.
4. Zapněte přepínač Veřejné koncové body a zapněte tak tuto funkci, poté podle potřeby zapněte nebo vypněte jednotlivé endpointy.

Každý endpoint má vlastní konfigurační panel pro podrobné nastavení.

Chcete-li povolit endpoint jmenného prostoru přes API, najdete postup v Veřejné endpointy jmenného prostoru.

Nakonfigurujte omezení počtu požadavků, abyste kontrolovali využití napříč všemi veřejnými endpointy:

Rate limity platí pro všechny povolené veřejné endpointy dané instance AI Search.

Sdílení prostředků mezi zdroji (CORS) je ve výchozím nastavení povoleno, aby podporovalo aplikace založené na prohlížeči.

Výchozí povolené origins závisí na typu vašeho zdroje dat:

• Datové zdroje typu web: Zdrojová doména se automaticky přidá jako povolený zdroj.
• Další zdroje dat: Všechny zdroje (*) jsou ve výchozím nastavení povoleny.

Povolené originy můžete upravit v Veřejné koncové body nastavení přidáním konkrétních hostitelských názvů do Autorizovaní hostitelé.

Popis nástroje je pole, které umožňuje přizpůsobit, jak je vaše instance AI Search popisována klientům MCP. Výchozí popis je Finds exactly what you're looking for. Tento popis pomáhá AI agentům pochopit, jaký obsah je k dispozici a kdy použít váš vyhledávací nástroj. Dobrý popis nástroje by měl vysvětlovat, jaký typ obsahu je indexován a na jaké druhy otázek dokáže odpovědět.

Například:

Search the Acme product documentation for information about
installation, configuration, API references, and troubleshooting
guides. Use this tool when users ask questions about how to set up
or use Acme products.

Veřejný endpoint nevyžaduje ověření. Kdokoli, kdo zná adresu URL, může dotazovat váš zaindexovaný obsah.

Chcete-li omezit, kdo může endpoint dotazovat, přidejte vlastní doména a zabezpečte ho pomocí Cloudflare Access. Uživatelé se poté ověří u vašeho poskytovatele identity, než jakýkoli požadavek dorazí k AI Search.

Pokud necháte endpoint otevřený:

• Indexujte pouze obsah, který je bezpečné zveřejnit.
• Nastavte limit frekvence požadavků a omezte tak zneužití.
• Zakažte koncové body, které nepoužíváte, například /mcp.
• Sledujte využití prostřednictvím analytiky ve svém dashboardu.