Ein Produkt finden
Nutze diese Fähigkeit, um aus „dem blauen Widget” oder einem gescannten Barcode ein konkretes SKU.io-Produkt zu machen –
seine id, sku, Name und Details – damit nachgelagerte Fähigkeiten einen eindeutigen Bezug haben.
Die richtige Suche wählen
| Du hast… | Aufruf | Warum |
|---|---|---|
| Eine exakte SKU | GET /api/products/by-sku?sku=WIDGET-BLUE-01 | Direkt, einzelnes Ergebnis |
| Einen gescannten Barcode (UPC/EAN/GTIN) | GET /api/products/barcode-lookup?code=0123456789012 | Löst den Barcode zu seinem Produkt auf (Parameter ist code) |
| Einen Teil-Namen oder Teil-SKU | GET /api/products/search?query=blue widget | Unscharf, kann mehrere Treffer liefern |
| Eine numerische Produkt-ID | GET /api/products/{id} | Vollständiger Datensatz, wenn du die ID bereits hast |
Bevorzuge immer die spezifischste Suche, die möglich ist. Verwende search nur, wenn du keine
exakte SKU oder keinen Barcode hast – es können mehrere Kandidaten zurückkommen, die du disambiguieren musst.
Schritte
-
Wähle die obige Suche basierend auf dem, was dir gegeben wurde.
-
Sende die Anfrage mit deinem Bearer-Token (Bereich
products:read):curl -sS "https://$SKU_TENANT.sku.io/api/products/by-sku?sku=WIDGET-BLUE-01" \ -H "Authorization: Bearer $SKU_PAT" -H "Accept: application/json" -
Behandle das Ergebnis:
- Genau ein Treffer → erfasse seine
idundsku; du bist fertig. - Suche hat mehrere zurückgegeben → schränke durch Abgleich der exakten
skuein, oder zeige dem Benutzer die besten Kandidaten (Name + SKU) an und frage, welcher es ist. Wähle nicht stillschweigend den ersten. - Kein Treffer → das Produkt existiert möglicherweise nicht oder ist archiviert. Melde dies, anstatt
eine ID zu erfinden. Ziehe eine breitere
search-Abfrage in Betracht, bevor du aufgibst.
- Genau ein Treffer → erfasse seine
Hinweise
searchist paginiert – sieheshared/pagination.md. Die besten Treffer befinden sich auf der ersten Seite; für eine Suche musst du selten weiterblättern.- Die Produkt-
idist der stabile Schlüssel, den andere Fähigkeiten erwarten (z.B.product_idin einer Verkaufsauftragsposition). Bevorzuge es,idnachgelagert weiterzugeben, anstatt jedes Mal per SKU neu aufzulösen.
API-Operationen
| Methode | Pfad | Beschreibung |
|---|---|---|
GET | /api/products/search | Unscharfe Produktsuche nach Name oder SKU-Fragment. |
GET | /api/products/by-sku | Ein einzelnes Produkt anhand seiner exakten SKU abrufen. |
GET | /api/products/barcode-lookup | Einen gescannten Barcode (UPC/EAN/GTIN) zu einem Produkt auflösen. |
GET | /api/products/{id} | Den vollständigen Produktdatensatz anhand seiner numerischen ID abrufen. |
Authentifizierung
Jede Anfrage authentifiziert sich mit einem SKU.io Personal Access Token, der als Bearer-Token gesendet wird:
Authorization: Bearer <YOUR_SKU_PAT>
- Basis-URL:
https://{tenant}.sku.io(ersetze{tenant}mit deiner Konto-Subdomain) - Erforderliche Bereiche:
products:read
Erstelle ein Token unter Einstellungen → Entwickler → Personal Access Tokens in der SKU.io Web-App.
Siehe shared/authentication.md für den vollständigen Ablauf.
Verbessere diese Fähigkeit
Hat diese Fähigkeit nicht gereicht – ein unklarer Schritt, ein falscher Endpunkt oder etwas, das sie nicht abschließen konnte? Umgehe es nicht einfach: Halte fest, was schiefgelaufen ist, und erstelle einen Pull-Request, damit der nächste Agent besser abschneidet.
- Repository: https://github.com/skuio/sku-skills
- Bearbeite die kanonische Fähigkeit unter
skills/<domain>/<name>/(nicht diese generierte Datei), führe dannnpm run buildaus und erstelle einen PR. Externe Mitwirkende: Forke das Repository und erstelle den PR vom Fork. - Der vollständige Agenten-Workflow befindet sich in
AGENTS.md.
Dein Agent kann dies von Anfang bis Ende durchführen. Die Bibliothek wird jedes Mal besser, wenn jemand eine Korrektur sendet.