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

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

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

ابدأ هنا

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

بناء التكامل

  • بثّ الرسائل والأدوات والنتائج
  • أبقِ خادمك الخلفي متحكّمًا

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

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

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

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

ابدأ هنا

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

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

عرض Markdown

قبل البدء

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

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

١. ثبّت حزمة SDK

تُدعَم Python بالإصدار 3.11 أو أحدث. ثبّت حزمة الإصدار القابلة للتنزيل.

bash
python -m pip install "wkala @ https://wkala.okal.io/downloads/wkala-0.1.0-py3-none-any.whl"

لخدمة Go مباشرة، مرّر base_url="http://localhost:8080/v1" عند إنشاء العميل. يستخدم مدخل Compose العنوان http://localhost:8088/v1، ويستخدم التطوير الأصلي متعدد الخدمات العنوان http://localhost:18080/v1، ويستخدم الإنتاج أصلًا عامًا مُهيأً. يقبل Python أيضًا عنوان الأصل دون إصدار للتوافق.

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

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

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

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

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

احفظ المثال باسم first_agent.py:

python
import asyncio
import os
import uuid

from wkala import AgentClient, SnapshotUpdate


async def main():
    async with AgentClient(api_key=os.environ["WKALA_API_KEY"]) as agents:
        session = await agents.sessions.create(title="First task")
        request_id = str(uuid.uuid4())
        run = await session.send(
            "Draft a concise release checklist for a web application.",
            idempotency_key=request_id,
        )
        print("Session:", session.id, "Run:", run.id)
        async with run.stream() as stream:
            async for update in stream:
                if isinstance(update, SnapshotUpdate):
                    print("Snapshot restored")
                else:
                    print(update.type, update.model_dump(mode="json", by_alias=True))
        result = await run.result()
        print(result.status, result.stop_reason)
        print(result.messages)


asyncio.run(main())

شغّله:

bash
python first_agent.py

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

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

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

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