דלג לתוכן הראשי
עיון בתיעוד

ערכות SDK

ערכות ה-SDK בצד השרת שמאמתות כוונות סוכן של Syncanix בבק-אנד שלכם — אחת לכל שפה, בשמונה סביבות פיתוח.

Syncanix מייצר משטח סוכן מעל ה-API הקיים שלכם — צ'אט בתוך האפליקציה, ועוד שרת MCP לכל דייר עבור Claude,‏ Cursor ו-ChatGPT. הסוכן יכול להריץ פעולות ללא שום SDK בצד השרת, תחת הזהות של כל משתמש סופי. הוסיפו אחד כשתרצו שהשרת שלכם יהיה קו ההגנה האחרון: SDK קליל מאמת שכל פעולה אושרה באמת על ידי Syncanix עבור אותו דייר ומשתמש לפני שאתם מריצים אותה.

מה עושה ערכת SDK בצד השרת

לכל ערכת SDK של Syncanix תפקיד אחד: לאמת את כותרת X-Syncanix-Intent החתומה שנלווית לכל קריאת כלי נכנסת. האימות הוא בדיקת HMAC מקומית ומהירה מול סוד חתימת הכוונות שלכם — בלי סבב רשת ובלי מצב משותף.

  • מוודאת שהבקשה נושאת כוונה תקפה שטרם פגה, שפלטפורמת Syncanix חתמה עליה — ולא קריאה מזויפת או משודרת מחדש.
  • חושפת את הטננט הפועל ואת משתמש הקצה (ה-subject של act-as-user ב-v2), כך שה-handler שלכם יוכל לתחום את הפעולה בדיוק לאותו משתמש.
  • רצה כולה בתוך התהליך: בדיקת חתימה חסרת-מצב, עם הגנת replay חד-פעמית אופציונלית שאתם מחברים למאגר משלכם.

מתי כדאי להוסיף

לא צריך אותו כדי לצאת לדרך — הסוכן משוחח ומריץ פעולות מול נקודות הקצה שהתגלו, נקודות הקצה המותאמות וכלי ה-MCP שלכם, תחת הזהות של כל משתמש סופי. הוסיפו SDK בצד השרת כשתרצו הבטחה חזקה יותר לפעולות עם תופעות לוואי — החזרים, עדכונים, ביטולים: הוא מאמת את הכוונה החתומה בכל קריאה, כך שבקשה מזויפת או משוחזרת שהפלטפורמה שלכם מעולם לא אישרה לא תגיע ללוגיקה העסקית שלכם. מומלץ לכתיבות רגישות, לא תנאי הכרחי.

התקנה

הוסיפו את ערכת ה-SDK לשפת הבק-אנד שלכם. Node מוגדר במדריך ההתחלה המהירה; לכל אחת משבע השפות האחרות יש עמוד ייעודי.

# 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
זמין בהשקה — החבילה הזו עדיין לא נמצאת ברישום הציבורי שלה, ולכן הפקודה שלמעלה תעבוד ביום שבו Syncanix נפתח.

בחרו את השפה שלכם

כל עמוד מלווה אתכם בהתקנת החבילה, בהגדרת סוד חתימת הכוונות, ובקטע קוד לאימות כוונה בפריימוורק האידיומטי של אותה שפה.

Node.jsExpress, NestJS, Fastify ו-Next.js — מוגדר במדריך ההתחלה המהירה לצד הגילוי והרכיב.PythonDjango, Flask ו-FastAPI, באמצעות middleware ודקורטורים.Gomiddleware ל-net/http, ל-Gin, ל-Echo ול-Fiber.Spring Bootהגדרה אוטומטית ל-Spring Boot ואנוטציה לאימות כוונה.PHPmiddleware ל-Laravel ו-event subscriber ל-Symfony.Rubycontroller concern ל-Rails ו-middleware ל-Rack.Rustextractors ל-Axum, ל-Actix Web ול-Tower.‎.NET‎ASP.NET Core Minimal API ו-MVC, ל-‎.NET‎ 8 ומעלה.

השלבים הבאים

מדריך API בזמן ריצהמעטפת הכוונה, כללי האימות וכל סיבות הכשל — משותפים לכל ערכות ה-SDK.פעולה בתור משתמש מחוברכיצד זרימת ה-act-as-user בגרסה v2 קושרת כל פעולה למשתמש הקצה שביקש אותה.