الطلبات والردود

وايو بيبعت إيه

اختار طريقة التوصيل اللي تناسب الـ endpoint اللي عندك. الأشكال دي شغالة مع الـ SDK كمان.

{"message":"Do you have a city bike in stock?"}

{"from":"wayo","text":"Do you have a city bike in stock?"}

https://your-business.example/search?q=Do%20you%20have%20a%20city%20bike%3F

أسماء parameters أو methods مختلفة، أو حقول متداخلة في الرد؟ استخدم HTTP مخصّص.

ردود الـ API المباشر غير ردود الـ SDK

{"answer":"We have 4 city bikes in stock."}

{"reply":"We have 4 city bikes in stock."}

مش محتاج HTTP مخصّص لمجرد إن الـ API بتاعك مسمّي الحقل answer.

ضيف المخزون والأسعار لما تفيد

{
  "reply": "The city bike is sold out.",
  "offers": [
    {
      "title": "City bike",
      "price": 180,
      "currency": "USD",
      "per": "item",
      "available": false
    }
  ]
}

استخدم أرقام للأسعار وكود عملة زي USD. حط بس المعلومات اللي جاية من نظامك. للأسئلة اللي مالهاش علاقة، رجّع رد فيه can_help: false. ولو البحث فشل، قول إنه فشل بدل ما تخمّن المخزون.

الجلسات والبيانات الجديدة

محادثات صندوق الوارد ممكن يبقى فيها قيمة session مالهاش معنى غير إنها مُعرّف. استخدمها عشان تفتكر سياق المحادثة؛ هي مش هوية الزبون الموثّقة. الـ SDK handlers بتستلمها كـ argument تاني اختياري.

الـ max_age الاختياري بيقول لوايو الرد ينفع يتعاد استخدامه كام ثانية كاملة لنفس اللي سأل. سيبه لو المخزون أو الأسعار بتتغير كتير. A2A بيرجّع أجزاء نص أو بيانات بالبروتوكول بتاعه.