حزم SDK
حزم SDK لجانب الخادم التي تتحقق من نيّات وكيل Syncanix على خادمك الخلفي — حزمة لكل لغة، عبر ثماني منظومات تقنية.
يُنشئ Syncanix واجهة وكيل فوق واجهة API الحالية لديك — محادثة داخل تطبيقك، إضافةً إلى خادم MCP لكل مستأجر لأجل Claude وCursor وChatGPT. يمكن للوكيل تنفيذ الإجراءات دون أي SDK من جهة الخادم، بهوية كل مستخدم نهائي. أضِف واحدًا عندما تريد أن يكون خادمك خط الدفاع الأخير: يتحقق SDK خفيف من أن كل إجراء صرّح به Syncanix فعلاً لذلك المستأجر والمستخدم قبل أن تُنفّذه.
ما الذي تفعله حزمة SDK لجانب الخادم
كل حزمة SDK من Syncanix تؤدي مهمة واحدة: التحقق من ترويسة X-Syncanix-Intent الموقَّعة التي ترافق كل استدعاء أداة وارد. والتحقق فحص HMAC محلي وسريع مقابل سرّ توقيع النيّة لديك — دون جولة شبكة ودون حالة مشتركة.
- يؤكد أن الطلب يحمل نيّة صالحة غير منتهية وقّعتها منصة Syncanix — لا استدعاءً مزوّرًا أو مُعاد إرساله.
- يُظهر المستأجر والمستخدم النهائي الفاعلَين (موضوع «التصرّف بصفة المستخدم» في v2) كي يقصر معالِجك الإجراء على ذلك المستخدم تحديدًا.
- يعمل بالكامل داخل العملية: فحص توقيع عديم الحالة، مع حماية اختيارية من إعادة الإرسال أحادية الاستخدام تربطها أنت بمخزنك الخاص.
متى تضيف واحدًا
لست بحاجة إليه للإطلاق — يحادث الوكيل وينفّذ الإجراءات على نقاط النهاية المكتشفة، ونقاط النهاية المخصصة، وأدوات 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اختر لغتك
تشرح كل صفحة تثبيت الحزمة، وضبط سرّ توقيع النيّة، ومقتطف تحقق من النيّة بإطار العمل الاصطلاحي لتلك اللغة.