Prostir

Praktyczny poradnik

Jak dodać widget agenta AI do swojej strony

Artykuł krok po kroku: jak dodać widget agenta AI do swojej strony. Tworzysz i publikujesz agenta Prostir, otwierasz Channels, wybierasz Web widget, dodajesz dokładny HTTPS allowed origin swojej strony, ustawiasz chat widget, klikasz Save, kopiujesz embed script, wklejasz go na stronę i testujesz website chatbot z działającej strony.

01

Czego potrzebujesz przed startem

  • Opublikowanego agenta Prostir z jawnym channel runtime model, włączonym przełącznikiem Channels na poziomie agenta oraz dodatnimi Model Usage Credits dla modelu hosted albo zapisanym kluczem BYOK.
  • Dokładnego publicznego originu strony, na której widget będzie działał, na przykład https://example.com. Użyj HTTPS, właściwego subdomain i nie wklejaj ścieżki typu /pricing.
  • Dostępu do website buildera, CMS, tag managera albo HTML template, gdzie możesz wkleić mały script przed </body> albo w pole site-wide custom code.
02

Jak dodać widget agenta AI

Schemat jest prosty: publikujesz agenta, tworzysz kanał Web widget, klikasz Save, kopiujesz script, wklejasz go na stronę i testujesz z allowed origin.

  1. 01
    Utwórz agenta AI w Prostir.

    Opisz, co website agent ma robić, dodaj strony, FAQ, docs, pricing notes, support rules i tools. Wybierz model, zanim pokażesz go odwiedzającym.

  2. 02
    Opublikuj agenta.

    Website widget używa published agent runtime. Jeśli agent jest tylko draft, embed script nie da stabilnego publicznego website chatbot.

  3. 03
    Otwórz Channels i wybierz Web widget.

    Włącz przełącznik Channels na poziomie agenta i wybierz Web widget. Zewnętrzny token nie jest potrzebny, ale kanał pozostaje wyłączony do przejścia kontroli runtime.

  4. 04
    Dodaj allowed origins.

    Dodaj każdy dokładny HTTPS origin, na którym widget może działać, np. https://example.com i https://www.example.com. Prostir blokuje niewpisane external origins, żeby inna strona nie użyła twojego widget script.

  5. 05
    Ustaw chat widget.

    Ustaw position, width, height, colors, greeting text, intro text, input placeholder, launcher label i quick actions. Pierwsze suggested actions powinny odpowiadać realnym pytaniom: pricing, booking, support, order status albo product fit.

  6. 06
    Kliknij Save.

    Save zapisuje ustawienia i włącza Web widget tylko po przejściu kontroli publikacji, jawnego runtime model, przełącznika Channels agenta, allowed origins, konfiguracji oraz kredytów hosted lub BYOK. W przeciwnym razie kanał pozostaje wyłączony z widocznym błędem.

  7. 07
    Skopiuj embed script.

    Skopiuj zwrócony widgetEmbedUrl. Zawsze używa opublikowanego sluga i dokładnego channel id: https://{slug}.ai.prostir.build/widget/embed.js?channelId={id}.

  8. 08
    Wklej script na stronę.

    Na ręcznie pisanej stronie wklej go przed </body>. W Webflow, WordPress, Shopify, Wix, Squarespace, Framer albo innym builderze użyj site-wide custom code, embed code albo custom HTML.

  9. 09
    Przetestuj z live site.

    Otwórz prawdziwą dozwoloną domenę, nie przypadkowy preview URL. Zadaj realne pytanie, sprawdź odpowiedź i potwierdź, że rozmowa pojawiła się w Channels.

03

Co przygotować przed Save

Dobry website AI agent to więcej niż dymek chatu.

docagent instructionsNa co widget odpowiada, czego ma odmawiać i kiedy ma wołać człowieka.
docwebsite knowledgePricing, services, FAQs, docs, policies, booking details, support rules i source pages.
codeembed scriptJednoliniowy script skopiowany z Prostir: <script src="https://{slug}.ai.prostir.build/widget/embed.js?channelId={id}" async></script>.
04

Ostatni krok w Prostir: Web widget, Save, script

Channels, Web widget, allowed origins, Save.

Prostir Studio

Opublikowałem support agent i chcę dodać go do strony jako AI chatbot widget.

Otwórz agenta w Prostir, przejdź do Channels, wybierz Web widget i dodaj dokładny HTTPS origin swojej strony.

Widget ma być w prawym dolnym rogu i zaczynać od pytań o pricing, booking i support.

Ustaw position, launcher label, greeting text, quick actions i colors. Kliknij Save, potem skopiuj embed script.

Prostir

Web widget zapisany. Kanał włącza się dopiero po wszystkich kontrolach runtime; inaczej pozostaje wyłączony z widocznym błędem.

Live

Website chatbot connected · embed script copied · rozmowy widoczne w Channels

05

Przetestuj widget na stronie

  • Użyj prawdziwej domeny z allowed origins. Jeśli testujesz z innego preview origin, widget może fail closed zgodnie z projektem.
  • Zadaj pytania, które zadałby lead: price, availability, next step, fit, support, refund albo implementation time.
  • Jeśli odpowiedź jest słaba, zaktualizuj instructions albo knowledge w Prostir, opublikuj ponownie, a embedded widget użyje poprawionego agenta bez przebudowy strony.

Co publikujesz

Na końcu twoja strona ładuje agenta AI Prostir przez widget embed script. Odwiedzający otwierają chat widget, pytają, a ten sam opublikowany agent odpowiada ze swoich instructions, knowledge, tools, modelu i ustawień kanału.

Rozwiązania

Agent sprzedażowy AI na stronę internetową, który prowadzi do jasnego kroku

Osadź kontrolowany Agent web widget, przekazuj tylko bezpieczny kontekst strony i pokazuj odpowiedź, tool activity, approval cards oraz właściwy CTA.

Rozwiązania

Zaplanuj pierwszą rozmowę na stronie

Podaj stronę, typowe obiekcje i właściwy kolejny krok. Pomożemy zbudować kontrolowany website Agent.