يعمل Freshness Validator
امنع وكلاء الذكاء الاصطناعي لديك من استخدام معلومات قديمة.
تتغير السياسات والأسعار ووثائق API، لكن وكيلك لا يلاحظ ذلك. يراقب Freshness Validator المصادر التي يعتمد عليها وكلاؤك ويخبرهم، في استدعاء واحد، ما إذا كانت معلوماتهم لا تزال صحيحة.
| السياق الذي يحمله الوكيل | الدرجة |
|---|---|
| الحد هو 100 طلب في الدقيقة لم يتغير المصدر منذ آخر فحص |
92 حديثة |
| ينتهي الدعم في الساعة 5 مساءً تم التحقق قبل 6 أيام، والسياسة 7 أيام |
74 تحذير |
| مهلة الاسترداد 30 يومًا تغيّرت صفحة المصدر بعد آخر تحقق |
58 قديمة |
لماذا تستخدمه الفرق
إجابات خاطئة أقل
يحصل العملاء والزملاء والأنظمة الأخرى على حقائق اليوم، لا على النسخة التي حمّلها وكيلك الشهر الماضي.
رموز أقل
بدلًا من تحميل مستندات كاملة في كل طلب احتياطًا، يعيد الوكيل قراءة المصدر فقط عندما يتغير فعلًا.
وقت أقل في إصلاح الأخطاء
لا بحث عن إجابات خاطئة بعد تغيير في السياسة، ولا تصحيح لشيفرة كُتبت من وثائق قديمة.
أمثلة من الواقع
تغيّر وثائق واجهة API
تحديث لائحة تنظيمية
ارتفاع الأسعار
كم ستوفّر؟
أدخل أرقامك الخاصة. تُجرى الحسابات في متصفحك.
ما الذي يفعله
- تقييم قائم على الوقت
- يقيّم السياق بحسب المدة التي مرت منذ التحقق منه، وفق سياسة حداثة تختارها: ساعة، أو 24 ساعة، أو 7 أيام، أو مدة مخصصة.
- مراقبة المصادر
- يجلب المصادر التي تسجّلها ويحسب تجزئتها وفق جدول زمني. وعندما تتغير صفحة، يُنبَّه إلى السياق الذي تم التحقق منه قبل التغيير.
- مطابقة المحتوى
- يقارن معلوماتك بنص الصفحة الحالي، خمس كلمات في كل مرة. تُحتسب التغييرات في النص الفعلي، ولا تُحتسب تغييرات التخطيط والبرامج النصية والتنسيق.
- REST وMCP
- استدعه عبر REST القياسي من خدمات الخلفية، أو عبر Model Context Protocol من الوكلاء. كلاهما يستخدم محرّك التحقق نفسه.
- الدفع لكل استدعاء
- يُخصم الرصيد المسبق الدفع مع كل فحص. وإذا كانت المحفظة فارغة، يعيد الاستدعاء HTTP 402 دون احتساب ويشرح كيفية إضافة رصيد.
- مفاتيح API لكل وكيل
- لكل وكيل مفتاحه الخاص. تُخزَّن الأسرار على شكل تجزئات SHA-256، وتُعرض مرة واحدة عند الإنشاء، ويمكن إلغاؤها واستبدالها في أي وقت. وتُقيَّد المحاولات الفاشلة المتكررة حسب عنوان IP.
كيف يعمل
- سجّل المصادر. أخبر الخدمة بصفحات الويب التي يستقي منها وكلاؤك معلوماتهم.
- تحقق من المعلومات. أرسل المعلومات التي يستخدمها وكيلك. ستحصل على درجة وعلامة تقادم واقتراحات.
- تصرّف وفق النتيجة. إذا كانت المعلومات قديمة، يعيد الوكيل قراءة المصدر ويتحقق مجددًا.
جرّبه
سجّل مصدرًا، ثم تحقق من المعلومات مقارنةً به. استبدل المفتاح المثال بمفتاحك.
# Register a source for monitoring (costs 2 validation calls)
curl -X POST https://api.myuiaf.com/api/v1/source/register \
-H "Authorization: Bearer fv1.acme-bot.k1.xxxxx" \
-H "content-type: application/json" \
-d '{"source_url":"https://example.com/api-docs","check_frequency":"6h"}'
# Validate agent context
curl -X POST https://api.myuiaf.com/api/v1/validate \
-H "Authorization: Bearer fv1.acme-bot.k1.xxxxx" \
-H "content-type: application/json" \
-d '{"context":"The API rate limit is 100 req/min","source_url":"https://example.com/api-docs"}'
{
"freshness_score": 72,
"is_stale": false,
"confidence": 0.85,
"source_match": { "method": "overlap", "overlap": 0.95 },
"flagged_issues": [],
"suggestions": [],
"source_status": "monitored",
"credits_deducted": 0.03,
"remaining_balance": 4.97
}
المرجع الكامل لواجهة API وإعداد MCP
الأسئلة الشائعة
ماذا يفعل Freshness Validator؟
يقيّم حداثة سياق وكيل الذكاء الاصطناعي من 0 إلى 100، بالجمع بين المدة منذ آخر تحقق، وما إذا كانت صفحة المصدر قد تغيّرت، ومدى تطابق النص مع المصدر حتى الآن. وتُصنَّف الدرجات الأقل من 70 على أنها قديمة.
هل يخزّن السياق الذي أرسله؟
لا. يُقيَّم السياق المُرسَل في الذاكرة ولا يُخزَّن. ولا يُحتفظ إلا بنص صفحات المصدر التي تسجّلها، لاكتشاف التغييرات.
هل يمكنني استخدامه من وكيل عبر MCP؟
نعم. محرّك التحقق نفسه متاح عبر REST على api.myuiaf.com وكخادم MCP على https://api.myuiaf.com/mcp.
كم يكلّف؟
من 0.03 دولار لكل استدعاء تحقق في مستوى Early Testing حتى 0.015 دولار في Enterprise. يكلّف تسجيل مصدر ما يعادل استدعاءين. ويمكن لوكيل بلا حساب دفع 0.05 دولار بعملة USDC مقابل استدعاء واحد.
ماذا يحدث عندما تكون المحفظة فارغة؟
يعيد الاستدعاء HTTP 402 دون احتساب ودون نتيجة، ويخبر الوكيل كيف يشتري مزيدًا من الرصيد أو يدفع مقابل هذا الاستدعاء.
يعمل مع AgentPay
يعمل مفتاح API نفسه والرصيد المسبق الدفع نفسه أيضًا مع AgentPay، بوابتنا للدفع لكل استدعاء إلى واجهات API لجهات خارجية. محفظة واحدة تغطي الخدمتين.