ما تفعله أداة search_talent
استخدمها في«أحتاج مهندسَي React Native بمستوى خبير يبدآن الشهر القادم».
لا تستخدمها فيالتسعير (استخدم estimate_squad_cost)، أو تأكيد موعد البدء (استخدم check_availability).
مخطط المدخلات
| الحقل | النوع | إلزامي | ملاحظات |
|---|---|---|---|
query | string | أحد الحقول query أو skills أو practice | نص حر حتى 200 حرف |
skills | string[] | أحد الحقول query أو skills أو practice | من 1 إلى 10 مهارات، مثل "Unreal Engine 5" |
practice | enum | أحد الحقول query أو skills أو practice | أحد رموز الممارسات التسع |
seniority | enum | لا | mid أو senior أو lead |
start_by | date | لا | آخر تاريخ مقبول للبدء |
residency | enum | لا | ksa أو uae أو eu أو us: منطقة بيانات العميل التي يجب أن يعمل المهندس وفقها |
language | enum | لا | en أو ar |
limit | integer | لا | من 1 إلى 25، والافتراضي 10 |
cursor | string | لا | من next_cursor |
مخطط المخرجات
- results[]: لكل نتيجة profile_id (معرّف مجهول، مثل anon_8F2KQ)، وheadline، وpractice، وseniority، وexperience_band (مثل "6–9 years")، وskills[] (متحقق منها في التقييم)، وlanguages[]، وtimezone (فرق التوقيت عن UTC)، وavailability (state: now أو from_date أو soft_held، مع available_from)، وresidency_patterns[]، وvetted (دائمًا true)، وvideo_available، وprofile_url.
- total: العدد التقريبي للمطابقات.
- next_cursor: يظهر عند وجود نتائج أخرى.
- notice: ملفات مجهولة الهوية. لا تُشارك الأسماء وبيانات التواصل إلا بعد اتفاقية عدم الإفصاح وطلب مقابلة يقبله المهندس.
مثال استدعاء واستجابة
Example (نثرًا)يستدعي المساعد search_talent بالمهارتين "Unreal Engine 5" و"rollback netcode"، والمستوى senior، وstart_by بتاريخ 2026-11-01، وresidency بقيمة uae، وlimit بقيمة 3. تعيد الاستجابة 3 ملفات من أصل 14 مطابقة. أولها anon_8F2KQ: مهندس أول في اللعب الجماعي والشبكات، بفئة خبرة 6–9 سنوات، ومهارات متحقق منها هي Unreal Engine 5 وC++ وrollback netcode، ويتحدث العربية والإنجليزية، بتوقيت UTC+2، وإتاحته now، ولديه فيديو تعريفي. ويتيح next_cursor جلب المزيد، ويقول الملخص النصي: 3 من 14 مهندسًا أول في شبكات Unreal يمكنهم البدء قبل 1 نوفمبر 2026.
الطلب
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_talent",
"arguments": {
"skills": [
"Unreal Engine 5",
"rollback netcode"
],
"seniority": "senior",
"start_by": "2026-11-01",
"residency": "uae",
"limit": 3
}
}
}الاستجابة
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "3 من أصل 14 مهندسًا بمستوى خبير في شبكات Unreal يمكنهم البدء بحلول 1 نوفمبر 2026."
}
],
"structuredContent": {
"results": [
{
"profile_id": "anon_8F2KQ",
"headline": "مهندس خبير في أسلوب اللعب والشبكات",
"practice": "game_development",
"seniority": "senior",
"experience_band": "6–9 years",
"skills": [
"Unreal Engine 5",
"C++",
"rollback netcode"
],
"languages": [
"en",
"ar"
],
"timezone": "UTC+2",
"availability": {
"state": "now"
},
"residency_patterns": [
"uae"
],
"vetted": true,
"video_available": true
}
],
"total": 14,
"next_cursor": "c_2",
"notice": ""
}
}
}الأخطاء
invalid_argument— يجب أن تكون seniority إحدى القيم mid أو senior أو lead؛ Remote Pro Ai لا توفر مهندسين بمستوى مبتدئinvalid_argument— أرسل واحدًا على الأقل من query أو skills أو practiceinvalid_argument— يقبل skills حتى 10 عناصر- rate_limited · unavailable
State (لا نتائج، وليس خطأ)total = 0، ويقترح الملخص تأخير start_by أو إزالة أحد المرشحات.
حدود الاستخدام والمصادقة
- عامة، دون رمز
- الحد دون مصادقة: 30 استدعاء في الدقيقة لكل IP، ومع المصادقة: 120 في الدقيقة لكل مؤسسة
- مع OAuth تُعلَّم في النتائج الملفات التي تحجزها مؤسستك بالفعل