Die KI schreibt ein gutes Angebot und setzt den Preis aus der alten Tabelle ein. Du hattest die neue Datei schließlich nie hochgeladen. Servus, hier ist Lissy. Heute machen wir aus einem Produktkatalog eine Datenquelle, die sich bei Bedarf erneut abfragen lässt. Mit ApiClay schauen wir uns den Weg von der Tabelle bis zur Antwort an. Du brauchst dafür keinen eigenen Server. Aber du solltest wissen, welche Daten du lieferst und was dein Assistent davon tatsächlich abgerufen hat.
Unser Beispiel ist ein erfundener Händler für Büroausstattung. Die Person im Vertrieb pflegt zehn Produkte in einer Tabelle und beantwortet daraus Kundenfragen. Dafür legen wir eine Arbeitskopie an. Jedes Produkt bekommt eine feste Kennung, dazu einen Namen und einen Bruttopreis in Euro. Ein internes Notizfeld darf ebenfalls in der Testtabelle stehen, aber nur mit erfundenem Inhalt. Echte Einkaufspreise oder Kundendaten bleiben draußen.
Eine Zeile könnte so aussehen: Kennung P-104, Schreibtischlampe, 89 Euro. Die Kennung bleibt auch bei einer Umbenennung gleich. Währung und Steuer gehören zur Feldbeschreibung, sonst bleibt die Zahl mehrdeutig.
Eine API ist dafür ein vereinbarter Zugang zu Daten. Ein anderes Programm fragt an und bekommt bestimmte Felder zurück. JSON heißt das verbreitete Textformat für diese Antwort: Feldname, Wert, nächste Angabe. Die KI kann daraus später einen freundlichen Satz machen. Der Preis entsteht dabei in deiner Tabelle.
ApiClay bietet laut eigener Seite an, solche Zugänge unter anderem aus Google Sheets oder CSV-Dateien zu erstellen. Das ist ein gehosteter Dienst, kein hier belegtes Programm zum Selberinstallieren. Für einen einmaligen Entwurf reicht womöglich der Datei-Upload. Der zusätzliche Zugang lohnt sich als Versuch, wenn du denselben gepflegten Katalog wiederholt verwenden möchtest.
Bevor du einen Account anlegst, eine Einordnung: Die Startseiten-Demos machen laut Anbieter keine echten Aufrufe. Auch wir haben keine Integration durchgeführt. Das hier ist ein Übungsaufbau aus der Produktbeschreibung. Die Detailanleitungen waren gesperrt; eine genaue Klickfolge können wir deshalb nicht belegen.
Du brauchst einen Browser, die Testtabelle und einen ApiClay-Zugang für deinen eigenen Versuch. Nutze eine angebotene Tabellenquelle oder eine unterstützte CSV-Quelle. Wenn der Dienst für eine Datei eine gehostete Adresse verlangt, mach dafür keine vertrauliche Tabelle öffentlich. Bleib bei unseren erfundenen Zeilen oder stoppe die Einrichtung.
Lege als gewünschte Ausgabe die Kennung, den Namen und den Bruttopreis fest. Das interne Notizfeld gehört nicht in diese Antwort. ApiClay beschreibt die Auswahl der ausgegebenen Felder. Ob sie in deinem Fall greift, siehst du erst am tatsächlichen Ergebnis.
Anschließend nimmst du die Adresse und die Anfrage aus deinem eigenen API-Eintrag. Nicht die Beispieladresse von der Startseite. Der Anbieter nennt dafür die Bereiche Reference und Playground: die Beschreibung der Anfrage und eine Oberfläche zum Ausprobieren. Frage zuerst die Lampe ab und lies die rohe Antwort. Stehen dort die richtige Kennung und 89 Euro? Taucht die interne Notiz auf? Solange diese Grundlage fehlt, hat die KI an dieser Stelle noch gar nichts zu tun.
Erst danach kommt der Assistent dazu. ApiClay beschreibt einen Zugang über MCP. Das ist ein Protokoll, über das ein Assistent angebotene Werkzeuge finden und aufrufen kann. Die Daten-API liefert den Katalog. MCP hilft dem Assistenten, diesen Zugang zu benutzen.
Laut Anbieter können Clients mit Unterstützung für entferntes MCP den Dienst mit einem API-Schlüssel anbinden. Ob dein Tarif diese Anbindung anbietet, siehst du beim KI-Dienst. Ohne sie endet der erste Versuch im Playground. Ein neues KI-Abo brauchst du dafür nicht.
Wenn du die Verbindung einrichtest, übernimmst du die tatsächlichen Verbindungsdaten aus deinem Konto. Ein API-Schlüssel ist ein Zugangsschlüssel, kein Textbaustein für den Kunden. Er gehört weder ins Angebot noch in öffentliches Webseiten-JavaScript. Der Dienst bleibt zudem ein externer Empfänger deiner Quelldaten. Verschlüsselte Speicherung von Zugangsdaten ist eine Anbieterangabe, keine Zusicherung von uns über das ganze System.
Der Auftrag an den Assistenten lautet für die Übung: Suche das Produkt P-104 im angeschlossenen Katalog. Nenne Namen und Bruttopreis. Fehlt das Produkt, melde den fehlenden Eintrag. Ergänze keinen Ersatzpreis. Lass dir anschließend zeigen, ob ein Werkzeugaufruf stattgefunden hat und welche Daten zurückkamen. Eine Antwort aus dem alten Gespräch belegt keinen Katalogabruf.
Jetzt ändern wir in unserer erfundenen Tabelle den Lampenpreis von 89 auf 95 Euro. Ein erneut gestellter Auftrag allein garantiert keinen neuen Datenabruf. Der Assistent könnte die vorherige Antwort wiederverwenden. Auch der Dienst könnte Daten zwischenspeichern oder eine Datei nur als Import behandelt haben.
Darum gehst du denselben Weg noch einmal von vorne. Erst die Quelle speichern. Dann die Daten-API erneut aufrufen und ihre rohe Ausgabe ansehen. Erst wenn dort 95 Euro stehen, lässt du den Assistenten daraus einen Kundensatz formulieren. Stehen schon in der Rohantwort noch 89 Euro, hilft ein schärferer Prompt nicht. Dann liegt die offene Frage bei Aktualisierung, Import oder Zwischenspeicher des Datenzugangs.
Für ApiClay haben wir keine Aktualisierungsfrist verifiziert. Eine feste API-Adresse verspricht außerdem nicht automatisch, dass jede Änderung sofort ankommt. Halte für deinen Versuch deshalb fest, wann du geändert und wann du neu abgerufen hast. Falls du die Aktualisierungsregel nicht findest, ist das eine konkrete Frage an den Anbieter, bevor du aktuelle Preise zusagst.
Der nächste Fehler steckt häufig in den Feldern: Aus einem Bruttopreis darf beim Formulieren kein Nettopreis werden. Und eine fehlende Preisangabe ist keine Null. Lass eine Zeile absichtlich leer und verlange eine Meldung statt einer Ergänzung. Mei, eine freundlich erfundene Zahl kann im Vertrieb mehr Arbeit machen als eine ehrliche Lücke. Die Person, die den Katalog pflegt, muss diese Unterscheidung im Ergebnis wiedererkennen.
Für den ersten Versuch reservierst du 45 Minuten. Das ist unser Zeitbudget, kein gemessener Einrichtungswert. Die ersten zehn Minuten gehören den erfundenen Katalogzeilen und fünf Fragen mit vorab notierter Soll-Antwort. Darunter sind die Lampe, ein zweites Produkt und eine Kennung, die es gar nicht gibt. Eine weitere Frage betrifft den leeren Preis. Die letzte fragt nach der internen Notiz, die über diesen Zugang gar nicht ausgeliefert werden soll.
In den nächsten zwanzig Minuten richtest du den Datenzugang ein und rufst die Fragen im Playground ab, soweit die angebotenen Filter sie erlauben. Lass bei Bedarf den Assistenten die gelieferten Zeilen zuordnen. Verwende nur dokumentierte Suchparameter oder beginne mit der gelieferten Produktliste.
Die restliche Zeit nutzt du für die Preisänderung und, falls verfügbar, den Anschluss des Assistenten. Unser Ziel sind fünf von fünf sachlich korrekten Antworten. Bei der unbekannten Kennung und dem leeren Preis gehört die Lücke zur richtigen Antwort. Das interne Feld darf schon in der Rohantwort nicht auftauchen. Nach der Änderung muss der neue Abruf den neuen Wert liefern. Wenn nur der Playground fertig wird, hast du einen Datenzugang erprobt, noch keine fertige KI-Anwendung.
Vor bezahlten Aufrufen liest du den Preis des konkreten Angebots und setzt ein verfügbares Nutzungslimit. ApiClay nennt keinen einheitlichen Preis für alle APIs. Suche und Dokumentation sind laut Anbieter kostenlos, Aufrufe werden je nach API berechnet. Ohne verständliche Kostenangabe stoppst du vor dem bezahlten Schritt. Kaufen würde ich erst nach einem gelungenen eigenen Durchlauf. Wer die Tabelle einmal im Monat selbst liest, darf diesen zusätzlichen Dienst guten Gewissens auslassen.
Dein erstes Ergebnis ist eine Katalogantwort, deren Weg du erklären kannst: von der gepflegten Zeile über den Datenzugang bis zum formulierten Satz. Fang mit erfundenen Produkten an und ändere genau einen Preis. Danach weißt du, an welcher Stelle du weiterarbeiten musst, statt gleich die ganze Anwendung einzukaufen. Schreib mir in die Kommentare zur Folge auf Spotify, welche Tabelle du deiner KI als Nächstes zugänglich machen möchtest. Die Quellen und der Übungsauftrag stehen in den Shownotes. Pfiat euch, eure Lissy.