Telepítési útmutató
Két dolognak kell élőben lennie a webhelyén: a tájékoztató, amelyet a látogatói látnak, és egy kis méretű nyilvános fájl, amely deklarálja az MI-használatát (yoursite.com/.well-known/ai-disclosure.json). A kódrészlet-címkét egyszer illeszti be, minden oldalon azonos, és a deklarációja dönti el, hogy melyik tájékoztató hol jelenik meg. Válassza ki a platformját alább; a legtöbb körülbelül tíz percet vesz igénybe.
Banner és MI-címkék, amelyeket a látogatói az oldalon látnak.
ai-disclosure.json, egy nyilvános fájl, amely a saját domainjéről olvasható.
az ellenőrző a 2. szint · Megjelenített állapotot mutatja.
Válassza ki a platformját
WordPress
A bővítmény telepítése
A WordPress adminban: Bővítmények → Új hozzáadása → Bővítmény feltöltése, válassza ki az alább letöltött fájlt, majd kattintson az Aktiválás gombra.
Végezze el mindkét feladatot
A bővítmény megjeleníti a tájékoztatókat, és automatikusan közzéteszi a deklarációs fájlját. Bármely bejegyzést vagy képet megjelölhet MI-tartalomként az „MI-tartalom” kapcsolójával. Nincs szükség kódszerkesztésre.
-
Ellenőrzés
Kész, amikor az ellenőrző a 2. szint · Megjelenített állapotot mutatja.
Ellenőrző futtatása
Shopify
A kódrészlet hozzáadása
Online Store → Themes → ⋯ → Edit code → theme.liquid: illessze be ezt az egyetlen címkét közvetlenül a </body> elé. A theme.liquid az az elrendezés, amelyen keresztül minden oldal megjelenik, így egyetlen beillesztés lefedi az egész áruházat. A Shopify nem tud fájlokat tárolni a domainje gyökerében, ezért a címke tartalmazza az AIDisclose webhelykulcsát (data-aidisclose), és betölti az általunk tárolt manifesztet.
theme.liquid <script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-aidisclose="YOUR_SITE_KEY" defer></script>A deklaráció összekapcsolása
Illessze be ezt a hivatkozást a <head> elembe ugyanabban a fájlban. A vezérlőpultja mindkét sort a webhelykulcsával előre kitöltve mutatja.
<head> <link rel="ai-disclosure" href="https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">Ez a specifikáció szerint engedélyezett módszer.
-
Ellenőrzés
Kész, amikor az ellenőrző az 1. szint · Deklarált állapotot mutatja egy megjegyzéssel. Ez a várt eredmény ezen a platformon, és megfelelő.
Ellenőrző futtatása
Webflow
A kódrészlet hozzáadása
Site settings → Custom code → Footer code: illessze be az alábbi kódrészlet-blokkot, majd Publish. A webhelyszintű egyedi kód minden oldalon betöltődik.
Footer code <script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-aidisclose="YOUR_SITE_KEY" defer></script>A deklaráció összekapcsolása
A Head code részben adja hozzá a deklarációs hivatkozás sorát (az alábbi második blokk). Inkább a saját domainjéről szolgáltatná a fájlt? Használja a Speciális beállítások alatti proxyt, ha a DNS-e a Cloudflare-en keresztül fut.
Head code <link rel="ai-disclosure" href="https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">Ez a specifikáció szerint engedélyezett módszer.
-
Ellenőrzés
Kész, amikor az ellenőrző az 1. szint · Deklarált állapotot mutatja egy megjegyzéssel. Ez a várt eredmény ezen a platformon, és megfelelő.
Ellenőrző futtatása
Squarespace
A kódrészlet hozzáadása
Settings → Advanced → Code Injection → Footer: illessze be az alábbi kódrészlet-blokkot. A kódbeszúrás minden oldalra érvényes. Ehhez a Business csomag szükséges.
Footer <script src="https://cdn.aidisclose.io/v1/aidisclose.js" data-aidisclose="YOUR_SITE_KEY" defer></script>A deklaráció összekapcsolása
A Header injection részben adja hozzá a deklarációs hivatkozás sorát (az alábbi második blokk).
Header <link rel="ai-disclosure" href="https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY">Ez a specifikáció szerint engedélyezett módszer.
-
Ellenőrzés
Kész, amikor az ellenőrző az 1. szint · Deklarált állapotot mutatja egy megjegyzéssel. Ez a várt eredmény ezen a platformon, és megfelelő.
Ellenőrző futtatása
Google Tag Manager
A címke létrehozása
New tag → Tag configuration → Custom HTML → illessze be a kódrészletet. Triggering: All Pages (Page View). Ne használjon késleltetett vagy görgetéses triggert: a tájékoztatási szabályok az első expozíciótól megkövetelik a tájékoztatót. Tegye közzé a munkaterületet.
Custom HTML <script src="https://cdn.aidisclose.io/v1/aidisclose.js" defer></script>Tegye közzé a deklarációját is
A Tag Manager csak a tájékoztatókat kezeli. A deklarációs fájljának is élővé kell válnia: kövesse a platformjához tartozó lépést a többi fülön, vagy a Custom code fület, ha saját webhelyet üzemeltet.
-
Ellenőrzés
Kész, amikor az ellenőrző a 2. szint · Megjelenített állapotot mutatja.
Ellenőrző futtatása
Egyedi kód
A kódrészlet hozzáadása
Egyszer helyezze el a webhely sablonjában vagy elrendezésében, a </body> elé, hogy minden oldallal együtt érkezzen. Az éles környezetre való megerősítés (verzió rögzítése, SRI) a Speciális beállítások alatt található.
HTML <script src="https://cdn.aidisclose.io/v1/aidisclose.js" defer></script>A deklarációs fájl szolgáltatása
Az ai-disclosure.json fájlnak olvashatónak kell lennie a domain /.well-known/ útvonalán. Vercel vagy Netlify esetén véglegesítse a fájlt a verziókezelőben. Ha a keretrendszer minden útvonalat az index.html fájlra ír át, ehhez a fájlhoz kivétel szükséges: lásd az Egyoldalas alkalmazások szakaszt a Speciális beállítások alatt. Az nginx és Apache konfigurációk szintén a Speciális beállítások alatt találhatók.
Vercel / Netlify # Vercel / Netlify: commit the file public/.well-known/ai-disclosure.json # SPA that rewrites every route to index.html? # Exclude /.well-known/ from the rewrite (see Advanced).-
Ellenőrzés
Kész, amikor az ellenőrző a 2. szint · Megjelenített állapotot mutatja.
Ellenőrző futtatása
Ellenőrzés
Futtassa az ellenőrzőt. Három dolgot igazol: a deklarációs fájlja érvényes, a kódrészlet fut, és a tájékoztatók valóban megjelennek az oldalon. (Mérnököknek: a C1, C3 és a C4-től C6-ig terjedő ellenőrzések.)
Ha a webhelye blokkolja az ellenőrzőnket (AIDiscloseBot)
Az ellenőrzések és a bizonyítékrögzítések az AIDiscloseBot/1.0 azonosítótól érkeznek. Csak nyilvános oldalakat olvas: soha nem jelentkezik be, soha nem küld be űrlapokat, és betartja a robots.txt szabályait. Ha a robots.txt vagy egy botvédelem blokkolja az ismeretlen bejárókat, engedélyezze kifejezetten:
User-agent: AIDiscloseBot
Allow: /
Kockázatos az engedélyezése? Nem. A robots.txt engedélye nem ad hozzáférést. Csak azt közli az udvarias botokkal, hogy elolvashatják a már nyilvános oldalakat. Bárki hamisíthat User-Agent karakterláncot, de egy hamisító semmi olyat nem nyer, amit a nyilvános oldalai már ne adnának meg neki.
Ha WAF-fal vagy botkezelővel szűri a forgalmat, soha ne engedélyezzen kizárólag a User-Agent alapján. Párosítsa forrásellenőrzéssel. A bejáró azonosságunkat és a kimenő IP-tartományokat, ahogy azokat kiosztjuk, itt tesszük közzé: aidisclose.io/bot.json.
Speciális beállítások
Theming with CSS variables, custom copy, single-page-app setup, and the full option reference are in the snippet reference.
A szkript pontos verzióhoz rögzítése (SRI)
A szkript-címkében elhelyezett integritás-hash miatt a böngésző megtagadja egy módosított fájl futtatását. Rögzítse a verziószámmal ellátott URL-t, és hozza létre a hasht pontosan abból a fájlból, amelyet telepít:
curl -sO https://cdn.aidisclose.io/v1/aidisclose.js
openssl dgst -sha384 -binary aidisclose.js | openssl base64 -A
Szolgáltassa a fájlt saját maga (nginx / Apache)
Az Ön által felügyelt kiszolgálókon szolgáltassa közvetlenül a letöltött ai-disclosure.json fájlt:
location = /.well-known/ai-disclosure.json {
alias /var/www/site/ai-disclosure.json;
default_type application/json;
add_header Cache-Control "max-age=3600";
}
Alias "/.well-known/ai-disclosure.json" "/var/www/site/ai-disclosure.json"
<Files "ai-disclosure.json">
ForceType application/json
</Files>
A vezérlőpulton tárolt fájl szolgáltatása a saját domainjéről
A kiszolgálója továbbítja hozzánk az arra az egy címre érkező kéréseket: Ön a vezérlőpulton szerkeszti a fájlt, az mégis a saját domainjéről szolgálódik ki. A vezérlőpult ezeket a webhelykulcsával előre kitöltve mutatja.
location = /.well-known/ai-disclosure.json {
proxy_pass https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY;
proxy_set_header Host cdn.aidisclose.io;
proxy_ssl_server_name on;
}
export default {
async fetch(request) {
const url = new URL(request.url);
if (url.pathname === "/.well-known/ai-disclosure.json") {
return fetch("https://cdn.aidisclose.io/v1/hosted-manifest/YOUR_SITE_KEY");
}
return fetch(request);
}
};
Egyoldalas alkalmazások és statikus tárhelyek
Azok a keretrendszerek, amelyek minden útvonalat az index.html fájlra írnak át, valamint egyes statikus tárhelyek elfogják a /.well-known/ai-disclosure.json kérést, és 200-as státusszal az alkalmazás HTML-jét adják vissza. Úgy tűnik, a fájl a helyén van, de az ellenőrző a manifeszt helyett a HTML-t olvassa be. Két megoldás: zárja ki a /.well-known/ útvonalat a mindent lefedő átírásból, hogy a statikus fájl application/json típussal jelenjen meg, vagy adja hozzá a data-aidisclose="YOUR_SITE_KEY" attribútumot a script címkéhez, hogy az AIDisclose által tárolt manifeszt töltődjön be, és a fájlt egyáltalán ne kelljen kiszolgálni.
# netlify.toml: serve the real file before the SPA fallback
[[redirects]]
from = "/*"
to = "/index.html"
status = 200
force = false # a real file at the path wins over this fallback
# vercel.json: rewrite everything EXCEPT /.well-known to the app
{ "rewrites": [
{ "source": "/((?!\.well-known/).*)", "destination": "/index.html" }
] }