ابدأ هنا
شغّل وكيلك الأول
ثبّت حزمة SDK، وأنشئ جلسة، وتابع تنفيذًا كاملًا عبر البث من خادمك الخلفي.
لتكامل Next.js ومتطلبات الواجهة الخلفية Python، راجع Next.js.
قبل البدء
أنشئ حسابًا في Wkala. أكّد بريدك الإلكتروني. انتظر موافقة المشغّل. يعيّن لك المشغّل المزوّد والنماذج والحدود. أنشئ مفتاحًا في لوحة التحكم. ابدأ بصلاحيتي القراءة والتشغيل. أضف صلاحية التهيئة لتسجيل الأدوات أو المهارات أو ملفات التعريف.
احتفظ بمفتاح الخدمة في خادمك الخلفي. لا تضعه في حزمة المتصفح أو متغيّر بيئة عام أو موجّه ذكاء اصطناعي منسوخ. يستخدم عميل المتصفح المسار /app من الأصل نفسه.
١. ثبّت حزمة SDK
استخدم Node بالإصدار 22.13 أو أحدث. ثبّت حزمة الإصدار القابلة للتنزيل.
npm install "https://wkala.okal.io/downloads/wkala-client-0.1.0.tgz"
لخدمة Go مباشرة، مرّر baseUrl: "http://localhost:8080/v1" عند إنشاء عميل الخادم. يستخدم مدخل Compose العنوان http://localhost:8088/v1، ويستخدم التطوير الأصلي متعدد الخدمات العنوان http://localhost:18080/v1، ويستخدم الإنتاج أصلًا عامًا مُهيأً.
٢. اضبط المفتاح
اضبط هذا المتغيّر في بيئة خادمك الخلفي:
export WKALA_API_KEY="your-private-service-key"
٣. أنشئ تشغيلًا وراقبه
ينشئ هذا المثال جلسة ويرسل مهمة لإعداد قائمة مراجعة للإصدار. يراقب التحديثات ويفحص النتيجة النهائية. احفظ معرّف الطلب المُولَّد قبل الإرسال إذا كان تطبيقك يحتاج إلى التعافي بعد إعادة التشغيل.
احفظ هذا المثال المتوافق مع JavaScript باسم first_agent.mjs:
import { createServerClient } from "@wkala/client/server"
const apiKey = process.env.WKALA_API_KEY
if (!apiKey) {
throw new Error("Set WKALA_API_KEY in your backend environment")
}
const agents = createServerClient({ apiKey })
const session = await agents.sessions.create({ title: "First task" })
const requestId = crypto.randomUUID()
const run = await session.send(
"Draft a concise release checklist for a web application.",
{ idempotencyKey: requestId },
)
console.log("Session:", session.id, "Run:", run.id)
for await (const event of run.events()) {
console.log(event.type, event.data)
}
const result = await run.result()
console.log(result.run.status, result.run.stop_reason)
console.log(result.messages)
شغّله:
node first_agent.mjs
تعيد send() التحكم بعد قبول الطلب. تواصل الخدمة التنفيذ بينما يراقبه تطبيقك. تشمل النتيجة الرسائل واستدعاءات الأدوات واستدعاءات الخادم الخلفي والتفاعلات والاستخدام. تظل عمليات التشغيل الفاشلة أو الملغاة قابلة للفحص. تحقّق من الحالة وسبب التوقف. إذا احتاج التشغيل إلى إدخال، فقد تظل المراقبة مفتوحة حتى يستجيب مكوّن آخر مخوّل. اتبع دليل الموافقات والأسئلة.
يُتاح الإصدار 0.1.0 كأرشيف npm قابل للتنزيل. لا يفترض أمر التثبيت نشر الحزمة في سجلّ حزم. تجد قيم التحقّق وروابط التنزيل في الصفحة الرئيسية للتوثيق.
٤. اختر الخطوة التالية
- ابثث الرسائل والأدوات.
- اربط أدوات الخادم الخلفي.
- اربط واجهة React عبر خادمك الخلفي الذي يتحقّق من الهوية.
- تعرّف على التكلفة والحدود قبل قبول أعمال بيئة الإنتاج.