تكامل JIRA

قم بربط مساعدك الذكي AI SmartTalk مع Atlassian JIRA لتمكين إدارة المشاريع الذكية وقدرات تتبع المشكلات. يتيح لك هذا التكامل البحث عن المشكلات، وإنشاءها، وتحديثها، وتسجيل الوقت، وإدارة السبرينت مباشرة من خلال تفاعلات اللغة الطبيعية.

نظرة عامة

يتيح لك تكامل JIRA مساعدتك الذكية:

• البحث عن المشكلات: العثور على المشكلات باستخدام استفسارات باللغة الطبيعية
• عرض تفاصيل المشكلة: الحصول على معلومات شاملة حول مشكلات معينة
• إنشاء مشكلات: توليد تذاكر جديدة أو مهام أو أخطاء تلقائيًا
• تحديث المشكلات: تعديل حالة المشكلة، والأولوية، والمكلف، وحقول أخرى
• تتبع الوقت: تسجيل وقت العمل مع تعليقات ووصف مفصل
• إدارة السبرينت: قائمة بالألواح، والسبرينت، وإدارة تخطيط السبرينت
• إدارة المشاريع: الوصول إلى معلومات المشروع وبيانات تعاون الفريق

المتطلبات الأساسية

قبل أن تبدأ، تأكد من أن لديك:

• حساب AI SmartTalk نشط مع إمكانية الوصول إلى تكوين المساعد
• نسخة من JIRA Cloud أو Server مع صلاحيات المسؤول
• تمكين الوصول إلى API في نسخة JIRA الخاصة بك
• بيانات اعتماد حساب المستخدم مع الأذونات المناسبة للمشاريع

خطوة بخطوة لإعداد

الخطوة 1: الوصول إلى تكامل JIRA

1. سجّل الدخول إلى حساب AI SmartTalk الخاص بك
2. انتقل إلى الإدارة → مساعدي → [اسم مساعدك]
3. انقر على الموصلات في الشريط الجانبي الأيسر
4. ابحث عن JIRA في قائمة الموصلات المتاحة
5. انقر على مربع تكامل JIRA

الخطوة 2: تكوين اتصال JIRA

1. رابط JIRA: أدخل رابط مثيل JIRA الخاص بك (على سبيل المثال، https://yourcompany.atlassian.net)
2. اسم المستخدم/البريد الإلكتروني: قدم عنوان بريدك الإلكتروني لحساب JIRA الخاص بك
3. رمز API: قم بإنشاء وإدخال رمز API الخاص بـ JIRA
   • انتقل إلى إعدادات حساب Atlassian الخاص بك
   • انتقل إلى الأمان → إنشاء وإدارة رموز API
   • أنشئ رمزًا جديدًا لتكامل AI SmartTalk
4. انقر على تكوين لإنشاء الاتصال

الخطوة 3: تمكين قدرات الذكاء الاصطناعي

قم بتكوين قدرات الذكاء الاصطناعي التي ترغب في تمكينها:

إدارة القضايا (4/4)

• ✅ JIRA_SEARCH_ISSUES: البحث وتصفية القضايا باستخدام اللغة الطبيعية
• ✅ JIRA_GET_ISSUE: استرجاع معلومات مفصلة حول قضايا معينة
• ✅ JIRA_CREATE_ISSUE: إنشاء قضايا جديدة، مهام، وأخطاء
• ✅ JIRA_UPDATE_ISSUE: تعديل القضايا الحالية وخصائصها

تتبع الوقت (1/1)

• ✅ JIRA_LOG_TIME: تسجيل وقت العمل مع التعليقات والأوصاف

إدارة السبرينت (2/2)

• ✅ JIRA_LIST_BOARDS_AND_SPRINTS: عرض اللوحات المتاحة والسبرينت النشطة
• ✅ JIRA_CREATE_SPRINT: إنشاء سبرينت جديدة وإدارة تخطيط السبرينت

الخطوة 4: مزامنة المشروع

1. انقر على مزامنة المشاريع لجلب مشاريع JIRA الخاصة بك
2. اختر المشاريع التي تريد أن يصل إليها مساعد الذكاء الاصطناعي الخاص بك
3. قم بتكوين الأذونات ومستويات الوصول الخاصة بالمشروع
4. انتظر حتى تكتمل المزامنة الأولية

قدرات مساعد الذكاء الاصطناعي

البحث وإدارة المشكلات

يمكن لمساعدك الذكي التعامل مع استفسارات اللغة الطبيعية مثل:

أمثلة البحث:

• "ابحث عن جميع المشكلات المتعلقة بالكوكيز"
• "أرني الأخطاء ذات الأولوية العالية المعينة لجون"
• "قم بإدراج جميع المهام في السبرينت الحالي"
• "ما هي المشكلات المفتوحة لمشروع CCS؟"

تفاصيل المشكلة:

User: "أخبرني عن المشكلة CCS-11"
AI: إليك تفاصيل CCS-11:
- العنوان: إعداد كوكيز الشوكولاتة بمحتوى مفصل
- الحالة: قيد التنفيذ
- الأولوية: منخفضة
- المعين: غير معين
- الوصف: [الوصف الكامل للمشكلة]

إنشاء المشكلات

إنشاء المشكلات من خلال الأوامر الحوارية:

أمثلة الإنشاء:

• "أنشئ تقرير خطأ لمشكلة تسجيل الدخول"
• "أضف مهمة لتنفيذ مصادقة المستخدم"
• "أنشئ قصة لميزة لوحة التحكم الجديدة"

تسجيل الوقت

تسجيل وقت العمل باستخدام اللغة الطبيعية:

أمثلة تتبع الوقت:

User: "@PO Bot أؤكد أن الكوكيز في الفرن لمشكلة CCS-11، وسأقوم بتسجيل ساعتين عند 200 درجة حرارة"

AI Response:
✅ تم تسجيل الوقت بنجاح لمشكلة CCS-11:
- الوقت المستغرق: ساعتان
- التعليق: الكوكيز في الفرن عند 200 درجة مئوية
- تاريخ البدء: 14 نوفمبر 2025، 12:00 مساءً

إدارة السبرينت

إدارة السبرينت واللوحات بطريقة حوارية:

أمثلة السبرينت:

• "ما هو موجود في سبرينتنا الحالية؟"
• "أنشئ سبرينت جديد للأسبوع المقبل"
• "أرني جميع اللوحات المتاحة"
• "نقل CCS-11 إلى السبرينت النشط"

ميزات JIRA المدعومة

أنواع المشكلات

النوع	مدعوم	قدرات الذكاء الاصطناعي
ملحمة	✅	إنشاء، تحديث، ربط المشكلات الفرعية
قصة	✅	عمليات CRUD كاملة، تقدير نقاط القصة
مهمة	✅	إدارة وتتبع المهام بالكامل
خطأ	✅	الإبلاغ عن الأخطاء، تعيين شدة، تتبع الحلول
مهمة فرعية	✅	إنشاء المهام الفرعية وربطها بالمشكلة الرئيسية

الحقول والخصائص

الحقل	قراءة	كتابة	فهم الذكاء الاصطناعي
الملخص	✅	✅	معالجة اللغة الطبيعية
الوصف	✅	✅	دعم النص الغني والتنسيق
الحالة	✅	✅	إدارة حالة سير العمل
الأولوية	✅	✅	تعيين الأولوية الذكية
المعين	✅	✅	التعرف على أعضاء الفريق
المراسل	✅	✅	رسم المستخدم تلقائيًا
التسميات	✅	✅	اقتراحات تسميات ذكية
المكونات	✅	✅	تنظيم قائم على المكونات
إصدار الإصلاح	✅	✅	دمج تخطيط الإصدار

استكشاف الأخطاء وإصلاحها

المشكلات الشائعة

مشاكل الاتصال

• فشل المصادقة:
  • تحقق من تنسيق عنوان URL الخاص بـ JIRA (تأكد من تضمين https://)
  • تحقق من صلاحية رمز API
  • تأكد من أن الحساب لديه الأذونات المناسبة
• انتهاء مهلة الشبكة:
  • تحقق من إمكانية الوصول إلى مثيل JIRA
  • تحقق من إعدادات جدار الحماية
  • اختبر الاتصال من خوادم AI SmartTalk

أخطاء الأذونات

• أذونات غير كافية:
  • راجع أذونات مشروع JIRA لحسابك
  • تحقق من أذونات تصفح المشروع وإنشاء القضايا
  • تحقق من الوصول الإداري لتكوين المشروع
• تم رفض الوصول إلى المشروع:
  • تأكد من إضافة المستخدم إلى المشاريع المستهدفة
  • تحقق من إعدادات رؤية المشروع
  • تحقق من تهجئة مفتاح المشروع

مشاكل المزامنة

• المشاريع لا تُحمّل:
  • قم بتحديث مزامنة المشروع
  • تحقق من أداء مثيل JIRA
  • تحقق من حدود معدل API
• فشل تحديثات القضايا:
  • تحقق من أذونات سير العمل للقضية
  • تحقق من متطلبات الحقول وقواعد التحقق
  • تأكد من أن القضية في حالة قابلة للتعديل

تحسين الأداء

حدود معدل API

• مراقبة الاستخدام: تتبع استدعاءات API وحدود المعدل
• عمليات الدفعة: قم بتجميع عمليات متعددة عند الإمكان
• استراتيجية التخزين المؤقت: نفذ تخزينًا مؤقتًا ذكيًا للبيانات التي يتم الوصول إليها بشكل متكرر

التعامل مع المثيلات الكبيرة

• تصفية المشاريع: مزامنة المشاريع ذات الصلة فقط
• تجزئة القضايا: التعامل مع مجموعات النتائج الكبيرة بكفاءة
• المزامنة الانتقائية: اختيار أنواع القضايا والحالات المحددة

أفضل الممارسات

تنظيم المشروع

• تسمية واضحة: استخدم أسماء وصفية للمشاريع والقضايا
• تسمية متسقة: حافظ على تصنيف تسميات متسق
• تنظيف منتظم: أرشفة المشاريع والقضايا المكتملة

حالات الاستخدام والأمثلة

أتمتة الاجتماع اليومي

عضو الفريق: "أرني ما عملت عليه بالأمس وما هو مخطط له اليوم"
AI: "بالأمس أكملت CCS-9 (سجلت 2 ساعة) و CCS-10 (سجلت 1.5 ساعة). 
اليوم لديك CCS-11 و CCS-12 المعينتين في السبرينت الحالي."

تخطيط السبرينت

مدير السبرينت: "أنشئ سبرينت جديد يبدأ يوم الاثنين لمدة أسبوعين"
AI: "✅ تم إنشاء سبرينت جديد 'Sprint 24' يبدأ في 18 نوفمبر 2025 لمدة أسبوعين. 
جاهز لإضافة القضايا من قائمة الانتظار."

الإبلاغ عن الأخطاء

مختبر الجودة: "أنشئ خطأ: نموذج تسجيل الدخول لا يتحقق من تنسيق البريد الإلكتروني بشكل صحيح، أولوية عالية"
AI: "✅ تم إنشاء خطأ CCS-15: 'مشكلة تحقق نموذج تسجيل الدخول من البريد الإلكتروني'
- الأولوية: عالية
- المعين إلى: فريق التطوير
- تمت إضافته إلى السبرينت الحالي للانتباه الفوري"

تتبع التقدم

مالك المنتج: "كيف تسير الأمور في مشروع إعداد الكعك؟"
AI: "حالة مشروع الكعك (CCS):
- 5 قضايا مكتملة (CCS-1 إلى CCS-5)
- 3 قيد التنفيذ (CCS-7، CCS-9، CCS-11)  
- 2 في قائمة المهام (CCS-12، CCS-13)
- إكمال السبرينت: 67% على المسار الصحيح"