انتقل إلى المحتوى
وكلاء من أوكال

جارٍ تحميل دليل الاستخدام…

وكلاء من أوكال
للوكلاءالتواصل
وكلاء من أوكال
مسار دليل الاستخدام
دليل الاستخدام

ابدأ هنا

  • شغّل وكيلك الأول

بناء التكامل

  • بثّ الرسائل والأدوات والنتائج
  • أبقِ خادمك الخلفي متحكّمًا
  • بناء واجهة React تفاعلية مباشرة
  • ربط تطبيق Next.js

الأدوات والسلوك

  • ربط خادم MCP بعيد
  • إضافة مهارات وتعليمات قابلة لإعادة الاستخدام
  • التعامل مع الموافقات والأسئلة والنماذج

التشغيل الموثوق

  • الأخطاء والتعافي
  • فهم الاستخدام والحدود
فهرس دليل الاستخدام للوكلاءدليل الاستخدام الكامل للوكلاء

ابدأ هنا

شغّل وكيلك الأول

ثبّت حزمة SDK، وأنشئ جلسة، وتابع تنفيذًا كاملًا عبر البث من خادمك الخلفي.

عرض Markdown

لتكامل Next.js ومتطلبات الواجهة الخلفية Python، راجع Next.js.

قبل البدء

أنشئ حسابًا في Wkala. أكّد بريدك الإلكتروني. انتظر موافقة المشغّل. يعيّن لك المشغّل المزوّد والنماذج والحدود. أنشئ مفتاحًا في لوحة التحكم. ابدأ بصلاحيتي القراءة والتشغيل. أضف صلاحية التهيئة لتسجيل الأدوات أو المهارات أو ملفات التعريف.

احتفظ بمفتاح الخدمة في خادمك الخلفي. لا تضعه في حزمة المتصفح أو متغيّر بيئة عام أو موجّه ذكاء اصطناعي منسوخ. يستخدم عميل المتصفح المسار /app من الأصل نفسه.

١. ثبّت حزمة SDK

استخدم Node بالإصدار 22.13 أو أحدث. ثبّت حزمة الإصدار القابلة للتنزيل.

bash
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، ويستخدم الإنتاج أصلًا عامًا مُهيأً.

٢. اضبط المفتاح

اضبط هذا المتغيّر في بيئة خادمك الخلفي:

bash
export WKALA_API_KEY="your-private-service-key"

٣. أنشئ تشغيلًا وراقبه

ينشئ هذا المثال جلسة ويرسل مهمة لإعداد قائمة مراجعة للإصدار. يراقب التحديثات ويفحص النتيجة النهائية. احفظ معرّف الطلب المُولَّد قبل الإرسال إذا كان تطبيقك يحتاج إلى التعافي بعد إعادة التشغيل.

احفظ هذا المثال المتوافق مع JavaScript باسم first_agent.mjs:

typescript
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)

شغّله:

bash
node first_agent.mjs

تعيد send() التحكم بعد قبول الطلب. تواصل الخدمة التنفيذ بينما يراقبه تطبيقك. تشمل النتيجة الرسائل واستدعاءات الأدوات واستدعاءات الخادم الخلفي والتفاعلات والاستخدام. تظل عمليات التشغيل الفاشلة أو الملغاة قابلة للفحص. تحقّق من الحالة وسبب التوقف. إذا احتاج التشغيل إلى إدخال، فقد تظل المراقبة مفتوحة حتى يستجيب مكوّن آخر مخوّل. اتبع دليل الموافقات والأسئلة.

يُتاح الإصدار 0.1.0 كأرشيف npm قابل للتنزيل. لا يفترض أمر التثبيت نشر الحزمة في سجلّ حزم. تجد قيم التحقّق وروابط التنزيل في الصفحة الرئيسية للتوثيق.

٤. اختر الخطوة التالية

  • ابثث الرسائل والأدوات.
  • اربط أدوات الخادم الخلفي.
  • اربط واجهة React عبر خادمك الخلفي الذي يتحقّق من الهوية.
  • تعرّف على التكلفة والحدود قبل قبول أعمال بيئة الإنتاج.
بثّ الرسائل والأدوات والنتائج