ما تفعله أداة check_availability
استخدمها في«هل يمكن أن يبدأ هذان المهندسان في 15 نوفمبر؟» أو «ما أقرب موعد لمهندس DevSecOps بمستوى قائد؟»
مخطط المدخلات
| الحقل | النوع | إلزامي | ملاحظات |
|---|---|---|---|
profile_ids | string[] | أحد الحقلين profile_ids أو roles | حتى 10، من نتائج search_talent |
roles | object[] | أحد الحقلين profile_ids أو roles | لكل عنصر: role وseniority وcount (من 1 إلى 20) |
start_by | date | لا | تاريخ البدء المستهدف |
duration_months | integer | لا | من 1 إلى 36 |
residency | enum | لا | ksa أو uae أو eu أو us |
onsite | enum | لا | none أو riyadh أو dubai |
مخطط المخرجات
- windows[]: نافذة لكل ملف أو دور، فيها earliest_start، وstart_commitment_working_days (دائمًا 4؛ ولأدوار التصريح تُحتسب من تاريخ منح العميل للتصريح)، وstate (now أو from_date أو soft_held أو booked)، وmatching_count (للأدوار فقط)، وconfidence (high أو medium أو low).
- hold_options: free_hold_hours (72) وdeposit_hold_days (7)، مع reserve_url.
- notes[]: تنبيهات بلغة واضحة، مثل: ملف واحد محجوز مبدئيًا لعميل آخر حتى 7 نوفمبر.
مثال استدعاء واستجابة
Example (نثرًا)يستدعي المساعد check_availability بالمعرّفين anon_8F2KQ وanon_3LZ7M، وstart_by بتاريخ 2026-11-15، وresidency بقيمة uae. تُظهر النافذة الأولى earliest_start في 2026-11-09، والحالة now، والتزامًا بالبدء خلال 4 أيام عمل، وثقة عالية. وتُظهر الثانية الحالة soft_held، وearliest_start في 2026-11-12، وثقة متوسطة، مع ملاحظة أن حجز عميل آخر ينتهي في 7 نوفمبر. وتعرض hold_options حجزًا مجانيًا لمدة 72 ساعة أو حجزًا لمدة 7 أيام بوديعة مستردة، ويفتح reserve_url صفحة الحجز.
الطلب
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "check_availability",
"arguments": {
"profile_ids": [
"anon_8F2KQ",
"anon_3LZ7M"
],
"start_by": "2026-11-15",
"residency": "uae"
}
}
}الاستجابة
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "يمكن أن يبدأ anon_8F2KQ في 2026-11-09، وanon_3LZ7M محجوز مبدئيًا حتى 7 نوفمبر."
}
],
"structuredContent": {
"windows": [
{
"profile_id": "anon_8F2KQ",
"earliest_start": "2026-11-09",
"start_commitment_working_days": 4,
"state": "now",
"confidence": "high"
},
{
"profile_id": "anon_3LZ7M",
"earliest_start": "2026-11-12",
"start_commitment_working_days": 4,
"state": "soft_held",
"confidence": "medium"
}
],
"hold_options": {
"free_hold_hours": 72,
"deposit_hold_days": 7,
"reserve_url": "https://remote-pro.ai/en/squads/book/quote"
},
"notes": [
"ملف واحد محجوز مبدئيًا لعميل آخر حتى 7 نوفمبر."
]
}
}
}الأخطاء
invalid_argument— أرسل profile_ids أو roles، لا كليهماinvalid_argument— يقبل profile_ids حتى 10 عناصرnot_found— الملف anon_XXXX لم يعد في المخزون؛ أعد تشغيل search_talent- rate_limited · unavailable
حدود الاستخدام والمصادقة
- عامة، دون رمز
- الحدود نفسها لكل الأدوات: 30 في الدقيقة دون مصادقة، و120 في الدقيقة مع المصادقة
- مع OAuth تتضمن النوافذ الملفات التي تحجزها مؤسستك بالفعل
لا تنشئ الأداة أي حجز؛ فالحجز يجري في الموقع بقرار المستخدم.