Zum Inhalt springen
StrikeUp Hilfe-Center
Versionshinweise

Von der Registrierung zum Assistenten in Ihrem Produkt

Für: Kontoinhaber und Entwickler, die StrikeUp zum ersten Mal einrichtenVoraussetzung: Die Rolle AdminScreenshots zeigen Beispieldaten

Diese Anleitung führt Sie von null zu einem KI-Assistenten, der Ihre Kunden direkt in Ihrem Produkt berät und für sie Ihre API aufruft. Sie legen Ihre Firma an, verbinden Ihre API als Toolkit, legen fest, was der Assistent darf, geben ihm eine Stimme, gestalten das Chat-Widget, prüfen die Schutzfunktionen und fügen ein Snippet in Ihr Produkt ein. Jeder Schritt verweist auf die Seite, die ihn vollständig erklärt. Planen Sie eine Stunde ein, das meiste davon für Entscheidungen statt für Klicks; bei einer großen Spezifikation dauert die Toolerzeugung länger.

Bevor Sie beginnen

Abschnitt betitelt „Bevor Sie beginnen“
Sie brauchenWo es liegt
Eine E-Mail-Adresse ohne StrikeUp-KontoIhr Postfach. Um stattdessen einer bestehenden StrikeUp-Firma beizutreten, bitten Sie deren Admin, Sie einzuladen.
Die Adresse der OpenAPI- oder Swagger-Spezifikation Ihrer API (JSON oder YAML) oder ihrer Readme.com-Referenz, aus dem Internet erreichbarDie Doku Ihrer API, oft endend auf openapi.json oder swagger.json
Die öffentliche Website Ihrer FirmaDamit werden die Guardrails auf Ihr Geschäft zugeschnitten
Zugangsdaten, mit denen StrikeUp Ihre API aufrufen kann, falls Ihre API welche verlangtDie Einstellungsseiten oder das Entwicklerportal Ihrer API
Zugriff auf das HTML des Produkts oder der Website, in dem der Assistent erscheinen sollIhr Code oder Ihr Website-Baukasten
Die Rolle Admin in StrikeUpErhalten Sie automatisch bei der Registrierung. User und Guest sehen jede Seite, können aber nichts speichern.

StrikeUp hat keine Tarife oder Funktionsstufen: Alles in dieser Anleitung steht jeder Firma zur Verfügung. Die Aufrufe von KI-Modellen beim Erzeugen der Tools und beim Beantworten von Besuchern erscheinen im Dashboard auf der Seite KI-Ausgaben.

Schritte

Abschnitt betitelt „Schritte“

  1. Ihre Firma anlegen. Öffnen Sie die Registrierungsseite über Konto erstellen auf der Anmeldeseite. Geben Sie Ihre E-Mail-Adresse, den Namen Ihrer Firma und ihre Website ein, dazu ein Passwort, das die Stärkeanzeige mindestens mit Gut bewertet. Wählen Sie Registrieren und öffnen Sie innerhalb von 24 Stunden den Bestätigungslink, den StrikeUp Ihnen mailt. Dann legt StrikeUp die Firma an, macht Sie zum Admin und meldet Sie an. Siehe Registrieren.

    Schritt 1, die StrikeUp-Seite „Registrieren“, ausgefüllt für ein neues Unternehmen: „E-Mail*“ enthält „olivia.hart@example.com“, „Firmenname (optional)“ enthält „Demo Ltd“, „Unternehmens-Website (optional)“ enthält „https://www.example.com“, beide Passwortfelder zeigen Punkte, die Stärkeanzeige steht auf „Sehr stark“. Hervorgehoben ist die blaue Schaltfläche „Registrieren“ unten in der Karte; sie legt das Unternehmen mit Ihnen als Administrator an und meldet Sie an. Unter der Karte: „Haben Sie bereits ein Konto? Hier anmelden“.Schritt 1, die StrikeUp-Seite „Registrieren“, ausgefüllt für ein neues Unternehmen: „E-Mail*“ enthält „olivia.hart@example.com“, „Firmenname (optional)“ enthält „Demo Ltd“, „Unternehmens-Website (optional)“ enthält „https://www.example.com“, beide Passwortfelder zeigen Punkte, die Stärkeanzeige steht auf „Sehr stark“. Hervorgehoben ist die blaue Schaltfläche „Registrieren“ unten in der Karte; sie legt das Unternehmen mit Ihnen als Administrator an und meldet Sie an. Unter der Karte: „Haben Sie bereits ein Konto? Hier anmelden“.
    Legen Sie Ihr Unternehmen mit „Registrieren“ an; die Website hilft StrikeUp, Guardrails auf Ihre Domain abzustimmen.
    Was dieser Screenshot zeigt
    Ansicht
    Registrieren (/auth/sign-up)
    Hervorgehoben
    button “Registrieren”, sign-up-card-bottom, enabled. creates the company and Admin account, then opens the setup wizard
    Außerdem sichtbar
    Email*: olivia.hart@example.com; Company Name: Demo Ltd; Company Website: https://www.example.com; Password strength: Very Strong
    Zweck
    quick-start step 1, create the account

  2. Den Einrichtungsassistenten abschließen. Der Assistent Willkommen bei StrikeUp öffnet sich von selbst und lässt sich erst schließen, wenn Sie fertig sind. Darin fügen Sie die Adresse Ihrer Spezifikation ein und wählen Validieren, legen fest, wie StrikeUp sich bei Ihrer API anmeldet, warten, während StrikeUp je Endpunkt ein Tool erzeugt, prüfen die vorgeschlagenen Regeln zur Maskierung und haken die ersten Tools an, die der Assistent nutzen darf, zum Beispiel mit Alle GET auswählen. Der Assistent legt auch Ihr erstes Chat-Widget an, benannt nach dem Toolkit mit dem Zusatz „Copilot“. Schließen Sie mit Einrichtung abschließen & zum Dashboard ab. Siehe Der Einrichtungsassistent.

  3. Eine weitere API verbinden (optional). Für jede weitere API öffnen Sie KonfigurierenToolkits und wählen am Ende der Reihe die Karte „Add toolkit“.

    Schritt 2, die Seite „Toolkits“ unter Konfigurieren mit dem Untertitel zum Verbinden und Konfigurieren von API-Toolkits. Eine Kartenreihe zeigt die verbundenen APIs „Demo Billing API“ (aktiv, 18/20 Tools), „Demo Accounts API“ (aktiv, 16/20 Tools) und „Demo Reporting API“ (aktiv, 8/8 Tools). Hervorgehoben ist die letzte Karte mit Pluszeichen, die auch in der deutschen Oberfläche englisch „Add toolkit“ heißt; sie öffnet den Dialog, in den Sie die Adresse Ihrer OpenAPI- oder Swagger-Spezifikation einfügen.Schritt 2, die Seite „Toolkits“ unter Konfigurieren mit dem Untertitel zum Verbinden und Konfigurieren von API-Toolkits. Eine Kartenreihe zeigt die verbundenen APIs „Demo Billing API“ (aktiv, 18/20 Tools), „Demo Accounts API“ (aktiv, 16/20 Tools) und „Demo Reporting API“ (aktiv, 8/8 Tools). Hervorgehoben ist die letzte Karte mit Pluszeichen, die auch in der deutschen Oberfläche englisch „Add toolkit“ heißt; sie öffnet den Dialog, in den Sie die Adresse Ihrer OpenAPI- oder Swagger-Spezifikation einfügen.
    Weitere APIs verbinden Sie unter Konfigurieren › Toolkits mit „Add toolkit“; das erste hat der Assistent bereits angelegt.
    Was dieser Screenshot zeigt
    Ansicht
    Toolkits (/admin/servers)
    Hervorgehoben
    card-button “Add toolkit”, toolkit-cards-right, enabled. opens the Create New Toolkit dialog
    Außerdem sichtbar
    Toolkit cards: Demo Billing API 18/20, Demo Accounts API 16/20, Demo Reporting API 8/8
    Zweck
    quick-start step 2, connect an API

    Behalten Sie in Neuen Toolkit erstellen die Option Swagger/OpenAPI oder wählen Sie Readme.io, fügen Sie die Adresse in API-Spezifikations-URL * ein und wählen Sie „Validate“. Prüfen Sie Namen und Kurzbeschreibung, die StrikeUp aus der Spezifikation übernommen hat, und wählen Sie dann „Create Server“. Der Dialog zeigt den Fortschritt der Erzeugung und schließt sich, wenn sie fertig ist; die Karte des Toolkits wird aktiv. Eine Mitteilung meldet, wenn StrikeUp Regeln zur Maskierung der neuen Felder vorschlägt. Die Anmeldung des Toolkits an Ihrer API legen Sie auf derselben Seite fest; Toolkits erklärt jede Art.

    Der Dialog „Neuen Toolkit erstellen“ über der abgedunkelten Toolkit-Seite; der Untertitel „Provide your API documentation URL to validate and extract server information.“ ist auch auf Deutsch englisch. „API-Dokumentationstyp *“ steht auf „Swagger/OpenAPI“, „API-Spezifikations-URL *“ enthält „https://api.example.com/accounts/v1/openapi.json“ mit dem Hinweis auf eine Swagger/OpenAPI-Datei (JSON oder YAML). Unten rechts stehen „Abbrechen“ und die hervorgehobene blaue Schaltfläche, die auch auf Deutsch „Validate“ heißt; sie liest die Spezifikation und zeigt Toolkitname und Anzahl der Endpunkte, bevor Sie das Toolkit anlegen.Der Dialog „Neuen Toolkit erstellen“ über der abgedunkelten Toolkit-Seite; der Untertitel „Provide your API documentation URL to validate and extract server information.“ ist auch auf Deutsch englisch. „API-Dokumentationstyp *“ steht auf „Swagger/OpenAPI“, „API-Spezifikations-URL *“ enthält „https://api.example.com/accounts/v1/openapi.json“ mit dem Hinweis auf eine Swagger/OpenAPI-Datei (JSON oder YAML). Unten rechts stehen „Abbrechen“ und die hervorgehobene blaue Schaltfläche, die auch auf Deutsch „Validate“ heißt; sie liest die Spezifikation und zeigt Toolkitname und Anzahl der Endpunkte, bevor Sie das Toolkit anlegen.
    Fügen Sie die Spezifikations-URL ein und wählen Sie „Validate“; StrikeUp erzeugt danach ein Tool pro Endpunkt.
    Was dieser Screenshot zeigt
    Ansicht
    Neuen Toolkit erstellen (/admin/servers)
    Hervorgehoben
    button “Validate”, dialog-footer-right, enabled. validates the specification (POST /api/servers/validate-spec)
    Außerdem sichtbar
    API Documentation Type: Swagger/OpenAPI; API Specification URL: https://api.example.com/accounts/v1/openapi.json
    Zweck
    quick-start step 2, the toolkit dialog filled in

  4. Die Tools einschalten, die der Assistent aufrufen darf. Wählen Sie unter KonfigurierenToolkits die Karte des Toolkits und scrollen Sie zu seiner Toolliste. Jedes aus einer Spezifikation erzeugte Tool ist anfangs ausgeschaltet, und der Assistent kann nur eingeschaltete Tools aufrufen. Schalten Sie Tools einzeln, je Gruppe oder über Massenaktionen ein, etwa mit Nur geringes Risiko aktivieren. Lesende Tools sind ein sicherer Anfang; Tools, die Daten ändern, kommen hinzu, wenn Sie den Assistenten bei der Arbeit gesehen haben. Siehe Toolkits.

    Schritt 3, die Toolkit-Seite mit ausgewähltem „Demo Accounts API“, gescrollt zur Tool-Liste. Darüber stehen die Toolkit-Details und die eingeklappte Autorisierungskonfiguration. Die Überschrift „Tools (20)“ steht über Filtern für Status und Risikostufe, einem Suchfeld, dem hervorgehobenen Menü „Massenaktionen“ und der Schaltfläche zum Hinzufügen eines Tools. Die Tools sind nach Ressource gruppiert, etwa „Account“ mit 1/2 aktiv und „Api-keys“ mit 4/4 aktiv, jeweils mit Schaltflächen zum Aktivieren und Deaktivieren aller Tools. „Massenaktionen“ schaltet viele Tools auf einmal, etwa alle mit geringem Risiko.Schritt 3, die Toolkit-Seite mit ausgewähltem „Demo Accounts API“, gescrollt zur Tool-Liste. Darüber stehen die Toolkit-Details und die eingeklappte Autorisierungskonfiguration. Die Überschrift „Tools (20)“ steht über Filtern für Status und Risikostufe, einem Suchfeld, dem hervorgehobenen Menü „Massenaktionen“ und der Schaltfläche zum Hinzufügen eines Tools. Die Tools sind nach Ressource gruppiert, etwa „Account“ mit 1/2 aktiv und „Api-keys“ mit 4/4 aktiv, jeweils mit Schaltflächen zum Aktivieren und Deaktivieren aller Tools. „Massenaktionen“ schaltet viele Tools auf einmal, etwa alle mit geringem Risiko.
    Der Assistent ruft nur eingeschaltete Tools auf; wählen Sie sie über „Massenaktionen“ oder die Schaltflächen jeder Gruppe.
    Was dieser Screenshot zeigt
    Ansicht
    Toolkits (/admin/servers?serverId=…)
    Hervorgehoben
    button “Massenaktionen”, tools-toolbar, enabled. opens bulk enable/disable options (by risk level)
    Außerdem sichtbar
    Tools (20); Groups Account 1/2 active, Api-keys 4/4 active; Enable All / Disable All per group
    Zweck
    quick-start step 3, choose which tools the assistant may call

  5. Dem Assistenten seine Stimme geben. Öffnen Sie KonfigurierenKI & UX und wählen Sie die Karte Ihres Widgets. Füllen Sie unter „Persona“ die Felder „Tone of voice (optional)“, „Behavior instructions (optional)“ und „Branding instructions (optional)“ aus und wählen Sie die blaue Speichern-Schaltfläche darunter. StrikeUp prüft die Anweisungen vor dem Speichern mit einer Sicherheitsprüfung und lehnt Text ab, der die eigenen Regeln des Assistenten aushebeln will oder ein Passwort oder einen Schlüssel enthält. Hat Ihre Firma Skills, schalten Sie unter „Skills“ die ein, die dieses Widget nutzen soll; jeder Schalter speichert sofort. Siehe KI & UX und Skills.

    Schritt 4, die Seite „KI & UX“ mit dem ausgewählten Widget „Demo Ltd Support chat“. Der Bereich Persona zeigt die Tonalität „Friendly, clear and concise. Plain English, no jargon.“, Verhaltensanweisungen zum Prüfen von Rechnungen und dazu, keine Erstattungen zu versprechen, sowie die Markenanweisung „Refer to the product as Demo Ltd. Sign off as the Demo Ltd assistant.“. Die Bereichstexte sind auch in der deutschen Oberfläche englisch. Hervorgehoben ist die blaue Schaltfläche „Save Persona“. Darunter listet der Bereich Skills Schalter wie „Invoice disputes“ und „Plan changes“.Schritt 4, die Seite „KI & UX“ mit dem ausgewählten Widget „Demo Ltd Support chat“. Der Bereich Persona zeigt die Tonalität „Friendly, clear and concise. Plain English, no jargon.“, Verhaltensanweisungen zum Prüfen von Rechnungen und dazu, keine Erstattungen zu versprechen, sowie die Markenanweisung „Refer to the product as Demo Ltd. Sign off as the Demo Ltd assistant.“. Die Bereichstexte sind auch in der deutschen Oberfläche englisch. Hervorgehoben ist die blaue Schaltfläche „Save Persona“. Darunter listet der Bereich Skills Schalter wie „Invoice disputes“ und „Plan changes“.
    Legen Sie pro Widget Tonalität, Verhaltensregeln und Markenauftritt fest und speichern Sie mit „Save Persona“.
    Was dieser Screenshot zeigt
    Ansicht
    KI & UX (/admin/configure/agents)
    Hervorgehoben
    button “Save Persona”, persona-section-bottom, enabled. saves tone, behaviour and branding instructions for the widget
    Außerdem sichtbar
    Widget cards: Demo Ltd Support chat (selected), Demo Ltd Help Centre widget; Tone of voice: Friendly, clear and concise. Plain English, no jargon.; Skills section with switches
    Zweck
    quick-start step 4, set up the assistant

  6. Das Chat-Widget gestalten. Öffnen Sie KonfigurierenUser Interface und wählen Sie Ihr Widget. Legen Sie fest, wie es auf Ihrer Seite erscheint (als Popup-Schaltfläche, als Seitenleisten-Fenster, als Panel oder als Bereich, den Ihre eigene Schaltfläche öffnet), seine Farben, die Seiten des Kundenbereichs, die Shortcut-Karten, die Besucher zuerst sehen, und die Regeln, auf welchen Seiten es erscheint. Prüfen Sie Kundenauthentifizierung erforderlich: Bei neuen Widgets ist das eingeschaltet, und dann legt jeder Besucher beim ersten Chat eine PIN oder ein Passwort fest. Speichern Sie alles auf einmal mit der Speichern-Schaltfläche unten auf der Seite. Siehe User Interface, Darstellungsarten und eigene Auslöser und Anmeldung von Endkunden (PIN oder Passwort).

    Schritt 5, die Seite „User Interface“ für das Widget „Demo Ltd Support chat“, gescrollt ans Ende der Einstellungen. Eine Leiste oben nennt das bearbeitete Widget. Zu sehen sind die letzten Kundenportal-Optionen, die Shortcut-Karten mit dem Begrüßungstext „Hi! I can help with invoices, plans, payments and your account.“ und vier Karten wie „Find an invoice“ und „Check API usage“ sowie die eingeklappten URL-Sichtbarkeitsregeln. Unten ist die blaue Schaltfläche hervorgehoben, die auch auf Deutsch „Save User Interface Settings“ heißt; sie speichert Darstellung, Farben, Portal, Shortcuts und Sichtbarkeitsregeln gemeinsam.Schritt 5, die Seite „User Interface“ für das Widget „Demo Ltd Support chat“, gescrollt ans Ende der Einstellungen. Eine Leiste oben nennt das bearbeitete Widget. Zu sehen sind die letzten Kundenportal-Optionen, die Shortcut-Karten mit dem Begrüßungstext „Hi! I can help with invoices, plans, payments and your account.“ und vier Karten wie „Find an invoice“ und „Check API usage“ sowie die eingeklappten URL-Sichtbarkeitsregeln. Unten ist die blaue Schaltfläche hervorgehoben, die auch auf Deutsch „Save User Interface Settings“ heißt; sie speichert Darstellung, Farben, Portal, Shortcuts und Sichtbarkeitsregeln gemeinsam.
    Gehen Sie Darstellung, Farben, Portal und Shortcut-Karten durch und speichern Sie alles mit „Save User Interface Settings“.
    Was dieser Screenshot zeigt
    Ansicht
    User Interface (/admin/configure/user-interface)
    Hervorgehoben
    button “Save User Interface Settings”, page-bottom, enabled. saves all User Interface settings of the selected widget
    Außerdem sichtbar
    Customer Portal visible pages; Shortcut cards: Find an invoice, Change my plan, Check API usage, Update payment method; URL Visibility Rules (collapsed)
    Zweck
    quick-start step 5, configure the widget's look and behaviour

  7. Die Guardrails prüfen. Öffnen Sie SicherheitLeitplanken. Die Guardrails beurteilen jede Besuchernachricht, bevor die KI antwortet, und blockieren Angriffe auf den Assistenten, schädliche Anfragen und Missbrauch. Während der Einrichtung hat StrikeUp eine Firmenrichtlinie geschrieben, die Ihr Geschäft beschreibt, anhand Ihrer Website-Adresse, Ihres Firmennamens und Ihrer Tools; sie ist bereits aktiv. Lesen Sie sie in Unternehmensrichtlinie (Bearbeitbar), passen Sie sie an das an, worüber Ihr Assistent sprechen soll und worüber nicht, und wählen Sie Unternehmensrichtlinie speichern. Tippen Sie dann unter Leitplanken testen eine typische Kundenfrage ein und wählen Sie Senden, um zu sehen, ob sie erlaubt ist. Siehe Leitplanken.

    Schritt 6, die Seite der Sicherheits-Leitplanken mit dem Hinweis, dass die globale Richtlinie für alle Organisationen gilt und nicht geändert werden kann. Die Karte „Unternehmensrichtlinie (Bearbeitbar)“ enthält ein Textfeld, das mit „ABOUT THIS BUSINESS“ beginnt, Demo Ltd als B2B-Plattform für Rechnungen und Abrechnung beschreibt und festhält, dass der Assistent keine Steuer- oder Rechtsberatung gibt. Darunter stehen „Clear Policy“ und die hervorgehobene blaue Schaltfläche „Unternehmensrichtlinie speichern“. Die Karte darunter testet eine Beispielnachricht gegen die Richtlinie.Schritt 6, die Seite der Sicherheits-Leitplanken mit dem Hinweis, dass die globale Richtlinie für alle Organisationen gilt und nicht geändert werden kann. Die Karte „Unternehmensrichtlinie (Bearbeitbar)“ enthält ein Textfeld, das mit „ABOUT THIS BUSINESS“ beginnt, Demo Ltd als B2B-Plattform für Rechnungen und Abrechnung beschreibt und festhält, dass der Assistent keine Steuer- oder Rechtsberatung gibt. Darunter stehen „Clear Policy“ und die hervorgehobene blaue Schaltfläche „Unternehmensrichtlinie speichern“. Die Karte darunter testet eine Beispielnachricht gegen die Richtlinie.
    Prüfen Sie die aus Ihrer Website erzeugte Unternehmensrichtlinie, passen Sie sie an, speichern Sie sie und testen Sie eine Nachricht.
    Was dieser Screenshot zeigt
    Ansicht
    Sicherheits-Leitplanken (/admin/security/guardrails)
    Hervorgehoben
    button “Unternehmensrichtlinie speichern”, company-policy-card-bottom-right, enabled. saves the company guardrail policy
    Außerdem sichtbar
    Company Policy (Editable) text: ABOUT THIS BUSINESS, Demo Ltd; Test Guardrails card with message box
    Zweck
    quick-start step 6, switch on guardrails

  8. Die Regeln zur Maskierung einschalten. Öffnen Sie SicherheitDatenmaskierung. Hat StrikeUp in Ihren APIs Felder wie Kartenprüfnummern oder IBANs gefunden, stehen die vorgeschlagenen Regeln oben. Wählen Sie Alle aktivieren oder schalten Sie sie einzeln ein. Eingeschaltete Regeln verbergen diese Werte in den Antworten Ihrer API, bevor die KI oder das Protokoll der Tool-Aufrufe sie sieht. Siehe Datenmaskierung.

    Schritt 7, die Datenschutzseite unter Sicherheit. Oben erklärt „KI-Vorschläge für Maskierungsregeln (2)“, dass die Regeln aus den Feldnamen Ihres Toolkits stammen; rechts ist die grüne Schaltfläche „Alle aktivieren“ hervorgehoben, daneben steht die Schaltfläche zum Verwerfen. Es folgen zwei Vorschläge: „payment_method.cvc“ („Card security code“, Demo Billing API, Vorschau „***“) und „refund.payout_iban“ („Refund payout IBAN“, Vorschau „GB29…6819“). Darunter listet „Datenschutz-Maskierung“ aktive Regeln wie „Card number“ und „IBAN“.Schritt 7, die Datenschutzseite unter Sicherheit. Oben erklärt „KI-Vorschläge für Maskierungsregeln (2)“, dass die Regeln aus den Feldnamen Ihres Toolkits stammen; rechts ist die grüne Schaltfläche „Alle aktivieren“ hervorgehoben, daneben steht die Schaltfläche zum Verwerfen. Es folgen zwei Vorschläge: „payment_method.cvc“ („Card security code“, Demo Billing API, Vorschau „***“) und „refund.payout_iban“ („Refund payout IBAN“, Vorschau „GB29…6819“). Darunter listet „Datenschutz-Maskierung“ aktive Regeln wie „Card number“ und „IBAN“.
    Aktivieren Sie die vorgeschlagenen Maskierungsregeln, damit Kartencodes, IBANs und ähnliche Felder nie unmaskiert an die KI gehen.
    Was dieser Screenshot zeigt
    Ansicht
    Datenschutz-Maskierung (/admin/security/data-privacy)
    Hervorgehoben
    button “Alle aktivieren”, suggestions-header-right, enabled. activates all suggested masking rules
    Außerdem sichtbar
    AI Suggested Masking Rules (2): payment_method.cvc, refund.payout_iban; Privacy Data Masking rules: Card number, IBAN
    Zweck
    quick-start step 7, mask sensitive data

  9. Richtlinien für Tools einrichten (optional). Unter SicherheitTool-Richtlinien fasst eine Richtlinie einige Ihrer Tools unter einem Schlüssel zusammen, angelegt mit Richtlinie erstellen. Für den ersten Start können Sie diesen Schritt auslassen: Eine Chat-Sitzung ohne Richtlinienschlüssel kann jedes Tool nutzen, das Sie im Toolkit eingeschaltet haben. Eine Richtlinie beschränkt einen Kunden nur, wenn Ihr Backend ihn mit einem einmaligen Anmelde-Ticket anmeldet, das ihren Schlüssel enthält. Lesen Sie Tool-Richtlinien und Tool-Richtlinien planen und simulieren, bevor Sie sich auf Richtlinien verlassen.

    Schritt 8, die Seite „Tool-Zugriffsrichtlinien“ zur Verwaltung des Tool-Zugriffs in Ihren Anwendungen. Eine Tabelle zeigt fünf Richtlinien mit ihren Tools: „View invoices“ (listInvoices, getInvoice, resendInvoice, exportInvoicesCsv), „Issue refunds“, „Manage subscriptions“, „Billing admin“ und „Read-only access“, jeweils mit Symbolen zum Bearbeiten und Löschen. Oben rechts stehen Aktualisieren, die Zugriffssimulation und die hervorgehobene blaue Schaltfläche „Richtlinie erstellen“, die eine neue Richtlinie für eine benannte Gruppe von Tools anlegt.Schritt 8, die Seite „Tool-Zugriffsrichtlinien“ zur Verwaltung des Tool-Zugriffs in Ihren Anwendungen. Eine Tabelle zeigt fünf Richtlinien mit ihren Tools: „View invoices“ (listInvoices, getInvoice, resendInvoice, exportInvoicesCsv), „Issue refunds“, „Manage subscriptions“, „Billing admin“ und „Read-only access“, jeweils mit Symbolen zum Bearbeiten und Löschen. Oben rechts stehen Aktualisieren, die Zugriffssimulation und die hervorgehobene blaue Schaltfläche „Richtlinie erstellen“, die eine neue Richtlinie für eine benannte Gruppe von Tools anlegt.
    Optional fassen Sie mit „Richtlinie erstellen“ Tools unter einem benannten Schlüssel zusammen, den Sie später simulieren können.
    Was dieser Screenshot zeigt
    Ansicht
    Tool-Zugriffsrichtlinien (/admin/feature-flags)
    Hervorgehoben
    button “Richtlinie erstellen”, top-right, enabled. opens the new policy form
    Außerdem sichtbar
    Policies: View invoices, Issue refunds, Manage subscriptions, Billing admin, Read-only access; Refresh and Tool Access Simulation buttons
    Zweck
    quick-start step 8, tool policies

  10. Das Widget in Ihr Produkt einbetten. Öffnen Sie KonfigurierenEmbed und wählen Sie Ihr Widget. Kopieren Sie das Snippet von der Embed-Seite mit „Copy embed code“: Es besteht aus einem Script-Tag, das das Widget lädt, und einem Aufruf, der es mit dem Token Ihres Widgets startet. Ersetzen Sie die Platzhalter wie your_customer_id und your_customer_display_name durch die Angaben der Person, die in Ihrem Produkt angemeldet ist. Fügen Sie das Snippet direkt vor dem schließenden </body>-Tag in das HTML Ihrer Seite ein. Siehe Embed, Das Widget in Ihr Produkt einbauen und Nutzer identifizieren und Kontext übergeben.

    Schritt 9, die Seite „Embed“ für das Widget „Demo Ltd Support chat“, gescrollt zum Code. Ein Codefeld zeigt das Script-Tag, das widget.js lädt, und den Aufruf window.initStrikeUpChatWidget mit dem applicationToken des Widgets und Platzhaltern wie „your_customer_id“ und „your_customer_display_name“ für den angemeldeten Nutzer. Darunter ist die breite Schaltfläche hervorgehoben, die auch auf Deutsch „Copy embed code“ heißt; sie kopiert den Code, den Sie direkt vor dem schließenden body-Tag in das HTML Ihrer Website einfügen.Schritt 9, die Seite „Embed“ für das Widget „Demo Ltd Support chat“, gescrollt zum Code. Ein Codefeld zeigt das Script-Tag, das widget.js lädt, und den Aufruf window.initStrikeUpChatWidget mit dem applicationToken des Widgets und Platzhaltern wie „your_customer_id“ und „your_customer_display_name“ für den angemeldeten Nutzer. Darunter ist die breite Schaltfläche hervorgehoben, die auch auf Deutsch „Copy embed code“ heißt; sie kopiert den Code, den Sie direkt vor dem schließenden body-Tag in das HTML Ihrer Website einfügen.
    Kopieren Sie den Code, ersetzen Sie die Platzhalter durch die Daten des angemeldeten Nutzers und fügen Sie ihn vor dem schließenden body-Tag ein.
    Was dieser Screenshot zeigt
    Ansicht
    Embed (/admin/configure/embed)
    Hervorgehoben
    button “Copy embed code”, snippet-bottom, enabled. copies the embed snippet to the clipboard
    Außerdem sichtbar
    Script tag loading widget.js; initStrikeUpChatWidget call with applicationToken and user placeholders
    Zweck
    quick-start step 9, embed the widget

  11. Als Kunde ausprobieren. Öffnen Sie die Seite mit dem Snippet, öffnen Sie den Chat und stellen Sie eine Frage, die eines Ihrer eingeschalteten Tools beantworten kann, etwa „Zeig mir meine letzte Rechnung“. Fragt das Widget nach einer PIN oder einem Passwort, legen Sie eines fest: Das ist Kundenauthentifizierung erforderlich bei der Arbeit. Der Assistent sollte mit Daten aus Ihrer API antworten.

Wie es weitergeht

Abschnitt betitelt „Wie es weitergeht“

Ihr Assistent läuft jetzt in Ihrem Produkt. Jede Besuchernachricht durchläuft die Guardrails, der Assistent plant seine Antwort, ruft die eingeschalteten Tools über Ihre API mit der festgelegten Anmeldung auf, maskiert sensible Felder in den Antworten und antwortet im Widget. Ändern Sie später in StrikeUp Persona, Aussehen, Tools oder Schutzfunktionen, müssen Sie das Snippet nicht anpassen.

So prüfen Sie, ob es funktioniert, und verfolgen die Nutzung:

WoWas Sie sehen
DashboardÜbersichtGeöffnete Chatfenster, erfolgreiche Tool-Aufrufe und Feedback für den gewählten Zeitraum. Siehe Übersicht.
AnalysenTool-LäufeJeden Aufruf des Assistenten an Ihre API, mit der maskierten Antwort. Siehe Tool-Läufe.
AnalysenVerstößeVon den Guardrails blockierte Besuchernachrichten. Siehe Verstöße.
DashboardKI-AusgabenDie geschätzten Kosten der Aufrufe von KI-Modellen. Siehe KI-Ausgaben.

Bevor Sie den Assistenten all Ihren Kunden ankündigen, arbeiten Sie Ihren Assistenten vor dem Livegang absichern durch.

Optionen

Abschnitt betitelt „Optionen“
WahlWann sinnvollWirkung
Den Assistenten nur mit lesenden Tools abschließenSie möchten den Assistenten bei der Arbeit sehen, bevor er Daten ändern kannDer Assistent kann nachschlagen, aber nichts anlegen, ändern oder löschen
Weitere APIs als Toolkits hinzufügenDie Daten Ihres Produkts liegen hinter mehreren APIsEin Widget kann bis zu 5 Toolkits nutzen; Toolnamen müssen über alle eindeutig sein
Kundenauthentifizierung erforderlich eingeschaltet lassenBesucher sehen eigene Daten oder können Aktionen auslösenJeder Besucher legt beim ersten Mal eine PIN oder ein Passwort fest
Kundenauthentifizierung erforderlich ausschaltenEin öffentlicher Assistent, der nur allgemeine Fragen beantwortetBesucher chatten ohne Anmeldeschritt
Ein Bereich, den Ihre eigene Schaltfläche öffnet, statt der schwebenden SchaltflächeDer Assistent gehört an eine bestimmte Stelle Ihres ProduktsSie fügen die Snippets zum Öffnen und Schließen von der Embed-Seite an Ihre eigenen Schaltflächen
Ihr Team einladenAndere sollen Gespräche verfolgen oder mit einrichtenLaden Sie sie unter EinstellungenBenutzer ein, nachdem Sie den Einrichtungsassistenten abgeschlossen haben, denn eine angenommene Einladung beendet ihn für alle

Wenn etwas schiefgeht

Abschnitt betitelt „Wenn etwas schiefgeht“
SymptomWas Sie prüfenLösung
Die Spezifikation wird abgelehntDie Adresse ist aus dem Internet erreichbar und zeigt auf eine JSON- oder YAML-Spezifikation, nicht auf eine Seite hinter einer AnmeldungFügen Sie die Adresse der .json- oder .yaml-Datei ein; siehe Toolkits
Der Assistent sagt, er könne etwas nicht, was Ihre API kannDas Tool für diesen Endpunkt ist ausgeschaltetSchalten Sie es unter KonfigurierenToolkits ein
Tool-Aufrufe scheiternDie Anmeldung des Toolkits und Ihre API-ZugangsdatenKorrigieren Sie die Anmeldung auf der Toolkit-Seite; den gescheiterten Aufruf sehen Sie unter AnalysenTool-Läufe
Normale Fragen werden blockiertDie Firmenrichtlinie ist zu engErweitern Sie sie unter SicherheitLeitplanken und testen Sie die Frage erneut
Das Widget erscheint nicht auf Ihrer SeiteDas Snippet ist vollständig, steht vor </body>, und die Regeln für die Sichtbarkeit erlauben diese SeiteKopieren Sie das Snippet erneut von der Embed-Seite; prüfen Sie die Regeln unter KonfigurierenUser Interface
Speichern scheitert mit „This action requires the Admin role.“Ihre RolleBitten Sie einen Admin, Ihre Rolle unter EinstellungenBenutzer zu ändern
Wissensdatenbank und Integrationen fehlen nach der Einrichtung im MenüIhre Sitzung begann vor dem Abschluss der EinrichtungMelden Sie sich ab und wieder an

Verwandte Seiten

Abschnitt betitelt „Verwandte Seiten“