Csatlakozás a nyilvántartáshoz (registry) — hirdetési portáloknak és kereskedői szoftvereknek

Ha Ön apróhirdetési portált, kereskedői vagy ügynökségi weboldalt, illetve sok kereskedő vagy ügynökség hirdetéseit közzétevő szoftvert üzemeltet, lehetővé teheti, hogy AI-asszisztensek folyamatosan figyeljék az Ön kínálatát az emberek számára — az Ön országában, az Ön nyelvén, az Ön webhelyén. A csatlakozás ingyenes, nem igényel sem fiókot, sem a mi jóváhagyásunkat, és egy fejlesztőnek általában körülbelül egy napot vesz igénybe.

Amit kap#

• Az AI-asszisztenseket használó emberek megtalálják az Ön hirdetéseit. Az az asszisztens, amely olvassa a nyilvántartást, látja, hogy Ön például használt autókkal foglalkozik Lengyelországban, és Önnél hagyhatja egy személy kívánságát („kombi 60 000 zł alatt, benzines, tavaszig”).
• A vevő az Öné marad. A kívánságot az Ön oldalán erősítik meg, egy e-mail-címmel, amelyet a személy ott ad meg. A találatok Öntől jutnak el a személyhez, az Ön hirdetéseire mutató linkekkel. A vevőről semmi sem halad át a nyilvántartáson vagy rajtunk.
• Se díj, se kizárólagosság. A nyilvántartásba vétel ingyenes. Megtartja a hirdetéseit, az árait és a kapcsolattartási folyamatát; bármikor kiléphet.

Amire szüksége van#

1. Egy szándékkezelői leíró (holder descriptor) — egy kis JSON-fájl a https://<your host>/.well-known/isto-intents.json címen, amely megmondja, kicsoda Ön, és milyen szervereket üzemeltet (séma, példa). A nyilvántartásba vételhez a következőt tartalmazza: "registry": { "listing": "requested", "terms": "https://istointents.org/registry/terms/" }. Írja be: "specVersion": "1.0": mindaz, amire egy portálnak itt szüksége van, az 1.0-s verzió óta stabil, és a 2.0-ig csak kompatibilis módon változik (verziókezelés).
2. Egy MCP-szerver ugyanazon a hoszton, Streamable HTTP, amely megvalósítja az MCP-kötést a consent-link profillal: a négy eszközt, intent_publish_intent, intent_get_intent, intent_list_matches és intent_withdraw_intent, a pontos interfészének mezőneveivel. Az asszisztensnek nem kell bejelentkeznie: az intent_publish_intent egy linket ad vissza az Ön oldalára, és ott csak maga a személy erősíthet meg.
3. Két szabály, amelyet az ellenőrzés kikényszerít: egy eszköz soha nem kér és nem ad vissza kapcsolattartási adatokat (egyetlen eszközben sem szerepel e-mail, telefonszám, név vagy cím), és a szerver azon a hoszton van, amely a leírót közzéteszi.

Az, hogy hogyan talál egyezéseket egy kívánsághoz — az Ön keresése, rangsorolása, értesítései —, az Önön múlik. A protokoll csak azt határozza meg, mit küld egy asszisztens, és mit kap vissza.

A nulláról indul? A referencia-szándékkezelő (reference holder) a fentiek mindegyike egyetlen, függőségek nélküli Node-fájlban — a négy eszköz, a hozzájárulási oldal (consent page) double opt-in megerősítéssel és a továbbító (forwarder) igazolása — tesztekkel együtt. Ön csatlakoztatja a levelezőrendszerét és a keresőjét; így, ahogy van, átmegy az ellenőrzésen és az alábbi próbafuttatáson (trial run). Ha látni szeretné, mely országokról kérdeznek az emberek, nézze meg a kereslet országonként oldalt.

Lépések#

1. Tegye közzé a leírót és az MCP-szervert.
2. Ellenőrizze a hosztját alább. Az ellenőrzés beolvassa a leírót, és pontosan úgy ellenőrzi a szervereit, ahogy a nyilvántartás fogja, de semmit sem vesz fel — annyiszor futtathatja, ahányszor csak akarja (hosztonként percenként egyszer).
3. Amikor a válasz ready, küldje be a hosztját: POST https://istointents.org/registry/v0/submit ezzel: { "host": "<your host>" }. Azonnal felkerül a nyilvántartásba, és automatikusan újraellenőrizzük; a leíró módosításai új beküldés nélkül megjelennek.
4. Opcionális — kívánságok fogadása olyan AI-asszisztensektől, amelyek még nem ismerik Önt. A legtöbb ember nem portálhoz csatlakoztatja az asszisztensét; egyszer egy továbbítóhoz csatlakoztatja, amely minden kívánságot egy olyan portálnak ad át, amely az adott személy országát szolgálja ki. E kívánságok fogadásához adja hozzá a leírójához: "forwarding": { "accept": "requested", "terms": "https://istointents.org/forwarding/terms/" }. A https://istointents.com/mcp címen működő továbbító ezután meghívja az Ön négy eszközét azon országok és kategóriák embereinek, amelyeket Ön kiszolgál; a személy továbbra is az Ön oldalán erősít meg, egy ott megadott e-mail-címmel, és a továbbító ezt soha nem látja. Ingyenes, és bármikor kikapcsolhatja ezzel: "accept": "withdrawn". Először olvassa el a Továbbítás (forwarding) fejezetet és a továbbítási feltételeket. Mielőtt bekapcsolja, jelölje be a próbafuttatás lehetőséget az alábbi ellenőrzésben (vagy küldje el: "trial": "publish"): a nyilvántartás ekkor egyszer meghívja az Ön négy eszközét, ahogy egy továbbító tenné, tesztként megjelölve és azonnal visszavonva, és megválaszolja, hogy készen áll-e a továbbításra (hogyan működik a próba).

A nyilvántartásba vétel nem tanúsítás: az ellenőrzés csak az interfészre terjed ki (hogyan működik). Minden üzemeltető maga felel a saját szolgáltatásáért. A nyilvántartás feltételei.

Adatvédelem. Ki melyik helyzetben adatkezelő, és mit kell az adatvédelmi tájékoztatójába felvennie: adatvédelmi segédlet portáloknak (nem jogi tanácsadás; angol nyelven).

Kérdések#

Írjon a protokoll szerkesztőjének az istointents.com oldalon keresztül. Itt semmit sem árulunk, és a csatlakozáshoz nem kell beszélnie velünk.