zum Hauptinhalt springen
Dokumentation durchsuchen

SDKs

Die serverseitigen SDKs, die Syncanix-Agent-Intents auf Ihrem Backend verifizieren — eines pro Sprache, über acht Ökosysteme hinweg.

Syncanix erzeugt eine Agenten-Oberfläche über Ihrer bestehenden API — Chat in Ihrer App, dazu ein mandantenspezifischer MCP-Server für Claude, Cursor und ChatGPT. Der Agent kann Aktionen ohne serverseitiges SDK ausführen, unter der eigenen Identität jedes Endnutzers. Fügen Sie eines hinzu, wenn Ihr Backend die letzte Verteidigungslinie sein soll: ein leichtgewichtiges SDK prüft, dass jede Aktion wirklich von Syncanix für diesen Mandanten und Nutzer autorisiert wurde, bevor Sie sie ausführen.

Was ein serverseitiges SDK tut

Jedes Syncanix-SDK hat genau eine Aufgabe: den signierten X-Syncanix-Intent-Header zu verifizieren, der jeden eingehenden Tool-Aufruf begleitet. Die Verifikation ist eine schnelle, lokale HMAC-Prüfung gegen Ihr Intent-Signing-Secret — ohne Netzwerk-Roundtrip und ohne geteilten Zustand.

  • Bestätigt, dass die Anfrage eine gültige, nicht abgelaufene Intent trägt, die die Syncanix-Plattform signiert hat — keinen gefälschten oder wiederholten Aufruf.
  • Legt den handelnden Tenant und Endnutzer offen (das v2-Act-as-User-Subjekt), sodass Ihr Handler die Aktion auf genau diesen Nutzer eingrenzen kann.
  • Läuft vollständig im Prozess: eine zustandslose Signaturprüfung, mit optionalem Einmal-Replay-Schutz, den Sie an Ihren eigenen Speicher anbinden.

Wann Sie eines hinzufügen sollten

Zum Start nicht nötig — der Agent chattet und führt Aktionen gegen Ihre erkannten Endpoints, benutzerdefinierten Endpoints und MCP-Tools unter der eigenen Identität jedes Endnutzers aus. Fügen Sie ein serverseitiges SDK hinzu, wenn Sie eine stärkere Garantie für Aktionen mit Nebenwirkungen wollen — Rückerstattungen, Aktualisierungen, Stornierungen: Es prüft die signierte Intent-Angabe bei jedem Aufruf, damit eine gefälschte oder wiederholte Anfrage, die Ihre Plattform nie autorisiert hat, nicht Ihre Geschäftslogik erreicht. Empfohlen für sensible Schreibvorgänge, keine Voraussetzung.

Installation

Fügen Sie das SDK für Ihre Backend-Sprache hinzu. Node wird im Schnellstart eingerichtet; die sieben anderen Sprachen haben jeweils eine eigene Seite.

# Node.js (Express, NestJS, Fastify, Next.js)
npm install @syncanix/sdk-node
# Python (Django, Flask, FastAPI)
pip install syncanix-sdk
# Go (net/http, Gin, Echo, Fiber)
go get github.com/syncanix-ai/syncanix-sdk-go
# Spring Boot (JVM)
implementation "ai.syncanix:syncanix-sdk-spring-boot"
# PHP (Laravel, Symfony)
composer require syncanix/sdk-php
# Ruby (Rails, Rack)
bundle add syncanix-sdk-rails
# Rust (Axum, Actix Web, Tower)
cargo add syncanix-sdk-rust
# .NET (ASP.NET Core)
dotnet add package Syncanix.Sdk.AspNetCore

Wählen Sie Ihre Sprache

Jede Seite führt durch die Installation des Pakets, die Konfiguration des Intent-Signing-Secrets und ein Verify-Intent-Snippet im idiomatischen Framework der jeweiligen Sprache.

Nächste Schritte