ابدأ هنا
شغّل وكيلك الأول
ثبّت حزمة SDK، وأنشئ جلسة، وتابع تنفيذًا كاملًا عبر البث من خادمك الخلفي.
قبل البدء
أنشئ حسابًا في Wkala. أكّد بريدك الإلكتروني. انتظر موافقة المشغّل. يعيّن لك المشغّل المزوّد والنماذج والحدود. أنشئ مفتاحًا في لوحة التحكم. ابدأ بصلاحيتي القراءة والتشغيل. أضف صلاحية التهيئة لتسجيل الأدوات أو المهارات أو ملفات التعريف.
احتفظ بمفتاح الخدمة في خادمك الخلفي. لا تضعه في حزمة المتصفح أو متغيّر بيئة عام أو موجّه ذكاء اصطناعي منسوخ. يستخدم عميل المتصفح المسار /app من الأصل نفسه.
١. ثبّت حزمة SDK
تُدعَم Python بالإصدار 3.11 أو أحدث. ثبّت حزمة الإصدار القابلة للتنزيل.
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 أيضًا عنوان الأصل دون إصدار للتوافق.
٢. اضبط المفتاح
اضبط هذا المتغيّر في بيئة خادمك الخلفي:
export WKALA_API_KEY="your-private-service-key"
٣. أنشئ تشغيلًا وراقبه
ينشئ هذا المثال جلسة ويرسل مهمة لإعداد قائمة مراجعة للإصدار. يراقب التحديثات ويفحص النتيجة النهائية. احفظ معرّف الطلب المُولَّد قبل الإرسال إذا كان تطبيقك يحتاج إلى التعافي بعد إعادة التشغيل.
احفظ المثال باسم first_agent.py:
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())
شغّله:
python first_agent.py
تعيد send() التحكم بعد قبول الطلب. تواصل الخدمة التنفيذ بينما يراقبه تطبيقك. تشمل النتيجة الرسائل واستدعاءات الأدوات واستدعاءات الخادم الخلفي والتفاعلات والاستخدام. تظل عمليات التشغيل الفاشلة أو الملغاة قابلة للفحص. تحقّق من الحالة وسبب التوقف. إذا احتاج التشغيل إلى إدخال، فقد تظل المراقبة مفتوحة حتى يستجيب مكوّن آخر مخوّل. اتبع دليل الموافقات والأسئلة.
يُتاح الإصدار 0.1.0 كحزمة wheel قابلة للتنزيل. لا يفترض أمر التثبيت نشر الحزمة في سجلّ حزم. تجد قيم التحقّق وروابط التنزيل في الصفحة الرئيسية للتوثيق.
٤. اختر الخطوة التالية
- ابثث الرسائل والأدوات.
- اربط أدوات الخادم الخلفي.
- اربط واجهة React عبر خادمك الخلفي الذي يتحقّق من الهوية.
- تعرّف على التكلفة والحدود قبل قبول أعمال بيئة الإنتاج.