xAgent · للمطورين
بيانات حية لمساعدك
اجعل مساعدك يعرف ما يحدث قبل أن يسأله أحد: درجة حرارة غرفة المعيشة، ومواعيد اليوم، وهل الباب الأمامي مقفل. تعطي xConsole عنوان خدمة ويب صغيرة؛ وفي بداية كل محادثة يقرأها XIOT ويضيف ما تعيده إلى ما يعرفه المساعد.
تُقرأ البيانات الحية مرة واحدة عند بداية المحادثة. إذا أردت أن يجلب المساعد شيئًا أو يغيّره أثناء الحديث، فاستخدم أدواتك الخاصة (MCP) بدلًا من ذلك، أو كليهما.
ما الذي يرسله XIOT
- طلب
GETإلى عنوانك من خوادم XIOT، لذا يجب أن يكون متاحًا من الإنترنت (استخدم HTTPS). - ترويسة
device-idتحمل عنوان MAC الخاص بـ xAgent، لتجيب كل جهاز بشكل مختلف. - أي ترويسات تضيفها في xConsole، مثل
Authorization.
يجب أن تجيب خدمتك خلال ٣ ثوانٍ. يُتجاوز الرد البطيء أو الفاشل وتستمر المحادثة دونه.
ماذا تُعيد
JSON يحتوي على "code": 0 ومعلوماتك في data: قيم مسماة، أو قائمة، أو نص واحد.
{
"code": 0,
"data": {
"درجة حرارة غرفة المعيشة": "24 °C",
"الباب الأمامي": "مقفل",
"الموعد التالي": "طبيب الأسنان الساعة 17:30"
}
}
عندها يعرف المساعد:
- درجة حرارة غرفة المعيشة: 24 °C
- الباب الأمامي: مقفل
- الموعد التالي: طبيب الأسنان الساعة 17:30
والقائمة تعمل بالطريقة نفسها، سطر لكل عنصر:
{ "code": 0, "data": ["لديك 3 مهام مستحقة اليوم", "مدرسة مريم تُغلق مبكرًا يوم الخميس"] }
أي قيمة أخرى لـ code تعني «لا شيء هذه المرة» وتُتجاوز.
أضفها في xConsole
- افتح الوكلاء ← إعداد الوكيل لمساعدك ← تبويب الأدوات.
- في السياق، اضغط تعديل المصدر، ثم إضافة.
- أدخل عنوانك، وترويسة مثل
Authorization: Bearer your-secretإذا كانت خدمتك تحتاجها. - أكّد، ثم احفظ الإعدادات. تستخدمها المحادثة التالية.
يمكنك إضافة عدة عناوين، وتُجمع أسطرها معًا.
مثال لخدمة صغيرة
تكفي مكتبة Python القياسية. ضعها خلف HTTPS (مثل وكيل عكسي أو نفق) قبل إضافتها إلى xConsole.
import json
from http.server import BaseHTTPRequestHandler, HTTPServer
SECRET = "Bearer change-me" # the same value as the header in xConsole
class Handler(BaseHTTPRequestHandler):
def do_GET(self):
if self.headers.get("Authorization") != SECRET:
self.send_response(401)
self.end_headers()
return
device = self.headers.get("device-id", "") # which xAgent is asking
body = {"code": 0, "data": {
"Living room temperature": "24 °C", # replace with your sensors or systems
"Front door": "Locked",
}}
data = json.dumps(body).encode()
self.send_response(200)
self.send_header("Content-Type", "application/json")
self.send_header("Content-Length", str(len(data)))
self.end_headers()
self.wfile.write(data)
HTTPServer(("0.0.0.0", 8080), Handler).serve_forever()
نصائح
- اجعلها قصيرة. فهي جزء من كل محادثة: بضعة أسطر مهمة أفضل من تقرير كامل، والأقصر يعني ردودًا أسرع.
- سمِّ الأشياء كما يقولها الناس. «الباب الأمامي: مقفل» أسهل على المساعد من «door_1: 0».
- احمِها. استخدم HTTPS وترويسة سرية، وتحقق منها في خدمتك.
- لا ترسل أسرارًا. ما تعيده يُعطى لنموذج الذكاء الاصطناعي مع تعليمات المساعد.