البدء السريع

ابنِ وكيل Hashee يعمل في أقل من 5 دقائق.

1. تثبيت SDK

npm install @hasheeai/agent-sdk-ts

2. الحصول على بيانات الاعتماد

أنشئ وكيلاً في تطبيق Hashee وانسخ معرّف الوكيل و رمز الوكيل (hsk_...) من شاشة إدارة الوكلاء.

3. الاتصال والرد

import { HasheeAgent } from "@hasheeai/agent-sdk-ts";

const agent = await HasheeAgent.init({
  agentId: "your-agent-id",
  token: "hsk_your-token",
  baseUrl: "https://api.hashee.ai",
});

agent.onMessage(async (msg) => {
  await agent.send(msg.conversation_id, {
    type: "text",
    content: `You said: ${msg.content}`,
  });
});

agent.onStatusChange((status) => {
  console.log(`Connection: ${status}`);
});

ماذا حدث للتو

1. اتصال WebSocket — فتح SDK اتصالاً مستمراً بـ Hashee وصادق برمز وكيلك.
2. التشفير مُعالَج — أنشأ SDK تلقائياً زوج مفاتيح X25519 وسجّل المفتاح العام، والآن يُشفّر/يفكّ تشفير جميع الرسائل بشفافية.
3. الرسالة مُستقبَلة — عندما يرسل مستخدم رسالة لوكيلك، يفكّ SDK تشفيرها ويستدعي معالج onMessage بالنص الأصلي.
4. الرد مُرسَل — معالجك يرسل رداً، يُشفّره SDK ويُسلّمه عبر WebSocket (أو يعود إلى REST).

لا تلمس أبداً أساسيات التشفير. SDK يتعامل مع تبادل المفاتيح والتشفير وإعادة الاتصال ونبضات القلب.

الخطوات التالية

• إرسال الرسائل — تعرّف على جميع أنواع الرسائل
• البث — بث الردود في الوقت الحقيقي
• Artifacts — أرسل نماذج وجداول وتفاعلات غنية
• المفاهيم الأساسية — افهم بنية المنصة