Phabricator/बॉट्स

Phabricator बॉट्स Phabricator के वे सदस्य हैं जिनके कार्य कई सदस्यों के कार्यों के परिणाम हैं या जिनके कार्य स्वाचिलत हैं। अधिक जानकारी के लिए अपस्ट्रीम प्रलेख देखें।

Phabricator बॉट्स मीडियाविकि बॉट्स जैसे ही हैं, और विकिमीडिया की साधारण बॉट नीति का ज़्यादातर हिस्सा इनपर लागू होता है।

phabricator.wikimedia.org पर पंजीकृत बॉट्स की सूची देखें।

व्यक्तिगत खातों से बॉट खातों को अलग करना

एक व्यक्तिगत सदस्य खाता, गतिविधि के दोहराव पैटर्न के लिए उचित नहीं है, क्योंकि मानवों के मामले में वे लगभग सार्वभौमिक रूप से स्पैम माने जाएँगे, या ज़्यादा-से-ज़्यादा लॉक कर दिए जाएँगे। अगर किसी स्पैम खाते से गतिविधि आती है, खाते को अक्षम कर दिया जा सकता है या हटा भी दिया जा सकता है। इन मामलों में अगर दोषी खाता किसी सदस्य का व्यक्तिगत खाता है, उन्हें स्थिति का वर्णन करने को नहीं कहा जाएगा।

एक बॉट प्राप्त करना

साधारण Phabricator खातों के विपरीत, जो किसी विकिमीडिया SUL या LDAP खाते से जुड़े होते हैं, बॉट खातों को Phabricator में ही बनाया जाता है। एक बॉट खाते का अनुरोध करने के लिए कृपया Phabricator-Bot-Requests परियोजना में एक टास्क बनाएँ और निम्न जानकारी जोड़ें:

• नाम
• उद्देश्य
• एक ईमेल पता (जो अमान्य हो सकता है मगर उसे अनूठा होना होगा)
• ज़िम्मेदार सदस्य या संगठन

Phabricator के प्रबंधकों का काम

यह रही Phabricator के प्रबंधकों के लिए ऐसे खाते बनाने की विधि:

• बॉट खाता बनाएँ
• पारदर्शिता के लिए, बॉट खाते के विवरण में मानव मालिक की जानकारी जोड़ें
• "Manage" पर जाएँ, "Edit settings" पर जाएँ, "Conduit API Tokens" पर जाएँ, "Generate Token" पर क्लिक करें। उस टोकन की प्रतिलिपि बनाएँ।
• उस टोकन वाला एक पोस्ट बनाएँ और "View policy" को मानव मालिक तथा खुद के लिए सेट करें
• निर्माण के अनुरोध वाले टास्क पर कड़ी चिपकाएँ और मानव मालिक से कहें कि अगर बॉट ठीक से काम कर रहा हो तो वह टास्क को बंद कर दें

बॉट खातों के मालिकों का काम

अपने बॉट खाते का उपयोग करने के लिए arc को कॉन्फ़िगर करने के लिए ये चरण हैं।

• अपने बॉट के लिए खाता प्रमाणपत्र प्राप्त करें
• इस तरह का एक arc कॉन्फ़िगरेशन फ़ाइल बनाएँ, फिर "<your bot account id>" और "<your bot certificate>" को उचित वैल्यूओं से बदल दें।

 {
   "config": {
     "default": "https:\/\/phabricator.wikimedia.org\/"
   },
   "hosts": {
     "https:\/\/phabricator.wikimedia.org\/api\/": {
       "token": "api-token_which_starts_with_api"
     }
   }
 }

• इस फाइल को कहीं सहेज लें। arc का डिफ़ॉल्ट स्थान है अपने मुख्य डिरेक्ट्री में ".arcrc" (लिनक्स और Mac पर ~/.arcrc), लेकिन अगर आपके पास मशीन पर पहले से ही एक arcrc फ़ाइल है, आप इसे कहीं और भी सहेज सकते हैं। इस उदाहरण के लिए हम वर्तमान कार्य के डिरेक्ट्री में "bot.arcrc" को रखेंगे।
• परीक्षण करने के लिए यह कमांड चलाएँ:

 $ arc tasks --unassigned --limit 1 --arcrc-file bot.arcrc

इसे Maniphest से एक ही कार्य का संक्षिप्त सारांश लौटाना चाहिए।