طلب عرض سعر فريق تطوير برمجيات عبر MCP
مخطط المدخلات
| الحقل | النوع | إلزامي | ملاحظات |
|---|---|---|---|
roles | object[] | نعم | لكل عنصر: role وseniority وcount، واختياريًا onsite (none أو riyadh أو dubai) وhours_per_month |
currency | enum | نعم | SAR أو AED أو USD أو EUR |
engagement | enum | لا | team_extension (الافتراضي) أو ready_squad أو managed_delivery |
duration_months | integer | لا | الافتراضي هو الحد الأدنى للمدة (شهر لـ team_extension، و3 أشهر لـ ready_squad وmanaged_delivery) |
buyer_country | string | لا | رمز ISO 3166 من حرفين، لملاحظة الضريبة |
profile_ids | string[] | لا | لتسعير ملفات محددة من search_talent |
مخطط المخرجات
- reference (مثل q_7HD29K) وvalid_until (بعد 30 يومًا من الإصدار).
- delivery بقيمة "email": يصل العرض المفصّل إلى بريد العمل للمستخدم؛ وeta_minutes بقيمة 2.
- currency وlines[] (role وseniority وcount) كما فهمها المحرك، دون مبالغ.
- lane: self_serve (للفرق الأصغر) أو reservation (للفرق المتوسطة) أو enterprise (للفرق الأكبر)، مع lane_note؛ وتُذكر الحدود في العرض.
- assumptions[]: مثل الدوام الكامل والعمل عن بُعد والحد الأدنى للمدة.
- vat_note: مثل: الأسعار لا تشمل ضريبة القيمة المضافة. للمشترين في السعودية 15%، وفي الإمارات 5%، وللشركات في الاتحاد الأوروبي احتساب عكسي.
- quote_url: صفحة العرض (رابط المستند والخطوات التالية) بعد إرسال البريد.
مثال استدعاء واستجابة
الطلب
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "estimate_squad_cost",
"arguments": {
"roles": [
{
"role": "Cloud Engineer",
"seniority": "senior",
"count": 2
},
{
"role": "Cloud Engineer",
"seniority": "lead",
"count": 1
}
],
"currency": "SAR",
"engagement": "team_extension",
"buyer_country": "SA"
}
}
}الاستجابة
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "التكلفة الشهرية التقديرية لثلاثة مهندسي سحابة، صالحة 30 يومًا. الأسعار لا تشمل ضريبة القيمة المضافة 15%."
}
],
"structuredContent": {
"quote_id": "q_7HD29K",
"valid_until": "2026-12-07",
"currency": "SAR",
"lines": [
{
"role": "Cloud Engineer",
"seniority": "senior",
"count": 2,
"monthly_amount": "priced by the pricing engine — delivered in the itemised quote (PDF) by e-mail"
},
{
"role": "Cloud Engineer",
"seniority": "lead",
"count": 1,
"monthly_amount": "priced by the pricing engine — delivered in the itemised quote (PDF) by e-mail"
}
],
"monthly_total": "priced by the pricing engine — delivered in the itemised quote (PDF) by e-mail",
"lane": "reservation",
"lane_note": "routed by the engine from the monthly total",
"assumptions": [
"full-time hours",
"remote delivery",
"minimum term: 1 month",
"multi-specialist discount applied by the engine"
],
"vat_note": "Prices exclude VAT. Saudi buyers: 15% VAT. UAE buyers: 5% VAT. EU business buyers: reverse charge.",
"quote_url": "https://remote-pro.ai/en/squads/book/quote?quote=q_7HD29K"
}
}
}الأخطاء
invalid_argument— يجب أن تكون العملة SAR أو AED أو USD أو EURinvalid_argument— هذا الدور غير موجود في الكتالوج؛ استخدم دورًا من نتائج search_talent أو صِفه في ملاحظات request_proposalinvalid_argument— يجب أن يكون count بين 1 و20 لكل دور- quote_expired (عند قراءة مرجع قديم) — انتهت صلاحية المرجع في date؛ اطلب عرضًا جديدًا
حدود الاستخدام والمصادقة
- عامة، دون رمز
- مع OAuth يُبنى العرض المرسل بالبريد على أسعار مؤسستك المتعاقد عليها وخصومات Squad Pack
- الحدود المعتادة: 30 في الدقيقة دون مصادقة، و120 في الدقيقة مع المصادقة