الوثائق

Jira

اقرأ واكتب تذاكر Jira (Cloud أو Server/Data Center) من داخل pipeline، بنمط BYO.

Jira

يربط تكامل Jira أداة تتبّع المشكلات لديك بالـ pipelines الخاصة بك: لـ قراءة حالة المشروع (التذاكر، الـ sprints، الانتقالات) ولـ التصرّف (إنشاء تذكرة، دفعها للأمام، التعليق). يعمل مع Jira Cloud و Jira Server / Data Center كليهما.

ما الذي يمكنك فعله به

  • البحث في التذاكر (JQL)، وقراءة تذكرة، وسرد المشاريع والـ انتقالات المتاحة.
  • إنشاء تذكرة، ونقلها من حالة إلى أخرى، وإضافة تعليق.
  • تغذية وكيل agent يلخّص تقدّم مشروع أو يفتح تذكرة تلقائياً من إشارة واردة (بريد إلكتروني، نموذج، تنبيه).

الأدوات والـ nodes

  • أدوات القراءة (تُتاح لوكيل agent): jira.search و jira.get_issue و jira.list_projects و jira.list_transitions.
  • أدوات الكتابة (مع تأكيد): jira.create_issue و jira.transition_issue و jira.add_comment.
  • node بـ jira_report — قراءة حتمية لمجموعة تذاكر، تُنشَر في السياق.
  • node بـ jira_create_issue — إنشاء تذكرة عند المُخرَج، بضمان exactly-once (لا تكرار عند إعادة المحاولة).

الربط (BYO)

  1. الإدارة ← التكاملات ← Jira.
  2. اختر النمط:
    • Jira Cloud — بريد إلكتروني + رمز API (مصادقة Basic، واجهة /rest/api/3).
    • Jira Server / Data Center — رمز شخصي (مصادقة Bearer، واجهة /rest/api/2).
  3. يُقفَل المضيف على https وتُتحقَّق مفاتيح التذاكر/المشاريع (حماية ضد SSRF). تُشفَّر بيانات الاعتماد في حالة السكون وتُحصَر بنطاق مؤسستك.

Jira موصِّل BYO صارم: بلا احتساب استهلاك، وبلا هامش من betool. تستخدم نسختك الخاصة وأذونات Jira الخاصة بك.

حالات الاستخدام

  • الدعم ← تذكرة — بريد إلكتروني وارد مؤهَّل من قِبل وكيل agent ينشئ تلقائياً تذكرة Jira في المشروع الصحيح.
  • تقرير التقدّم — كل صباح، يقرأ pipeline التذاكر المفتوحة ويرسل تحديث حالة قابلاً للقراءة إلى الفريق.