कॉन्फ़िगर करना Copilot Studio

"अवलोकन"

कैटो, एपीआई एक्सेस के माध्यम से Copilot Studio वातावरण से कनेक्ट होता है, जिससे प्रशासकों को संगठन में बनाए गए एजेंटों और उनकी गतिविधियों की दृश्यता मिलती है।

आवश्यक चीजें

शुरू करने से पहले, निम्न बात की पुष्टि करें:

• आपके पास एप्लिकेशन प्रशासक, क्लाउड एप्लिकेशन प्रशासक, या वैश्विक प्रशासक भूमिका के साथ Microsoft Entra ID (Azure AD) खाता है। यह भूमिका आपको चरण 1 में कैटो एप्लिकेशन के लिए किरायेदार-व्यापक सहमति देने की अनुमति देती है। Cato का एप्लिकेशन केवल एक बुनियादी साइन-इन अनुमति का अनुरोध करता है, इसलिए एप्लिकेशन प्रशासक या क्लाउड एप्लिकेशन प्रशासक कम से कम विशेषाधिकार वाली विकल्प होता है और यह पर्याप्त होता है।
• आपके पास किरायेदार स्तर पर पावर प्लेटफ़ॉर्म प्रशासक या वैश्विक प्रशासक पहुंच है। यह एक अलग, पावर प्लेटफ़ॉर्म-विशिष्ट अनुमति है बजाय Entra ID ऐप पंजीकरण के, और यह आपको चरण 2 में कैटो एप्लिकेशन को एक प्रबंधन एप्लिकेशन के रूप में पंजीकृत करने और चरण 3 में एजेंट सत्रों को सक्षम करने की अनुमति देता है।
• आपके पास Copilot Studio से संबद्ध Azure सब्सक्रिप्शन तक पहुंच है, चरण 2 में एक क्लाउड शेल सत्र खोलने के लिए
• आप Azure Cloud Shell में PowerShell कमांड चला सकते हैं, चरण 2 में पंजीकरण स्क्रिप्ट चलाने के लिए

इस एकीकरण की सेटअप प्रक्रिया चार चरणीय प्रक्रिया होती है, और अक्सर विभिन्न लोग इसे पूरा करते हैं। चरण 1 में, Entra ID प्रशासक किरायेदार में कैटो एप्लिकेशन जोड़ता है। चरण 2 और 3 में, पावर प्लेटफ़ॉर्म प्रशासक कैटो एप्लिकेशन को एक प्रबंधन एप्लिकेशन के रूप में पंजीकृत करता है और एजेंट सत्रों को सक्षम करता है। चरण 4 में, कैटो व्यवस्थापक CMA में एकीकरण को पूरा करता है।

चरण 1: Cato को Microsoft Entra ID से कनेक्ट करें

Cato Microsoft Entra ID में एक बहु-किरायेदार एप्लिकेशन पंजीकृत करता है। एकीकरण को जोड़ने के लिए, Entra ID व्यवस्थापक कैटो नेटवर्क्स व्यवस्थापक सहमति लिंक खोलता है, जो आपके किरायेदार को एप्लिकेशन को एंटरप्राइज एप्लिकेशन के रूप में जोड़ता है और इसे सहमति देता है।

Microsoft Entra ID के साथ Cato कनेक्ट करने के लिए:

1. कैटो नेटवर्क्स एडमिन कंसेंट लिंक खोलें। प्रॉम्प्ट मिलने पर पूर्वापेक्षाओं में वर्णित प्रशासक खाते के साथ साइन इन करें। Microsoft कैटो नेटवर्क्स एआई सुरक्षा एकीकरण एप्लिकेशन के लिए सहमति स्क्रीन प्रदर्शित करता है।
2. स्वीकार करें पर क्लिक करें।

चरण 2: Cato को पावर प्लेटफ़ॉर्म में प्रबंधन एप्लिकेशन के रूप में पंजीकृत करें

यह कदम चरण 1 से वही कैटो एप्लिकेशन पावर प्लेटफ़ॉर्म के साथ प्रबंधन एप्लिकेशन के रूप में पंजीकृत करता है। सामान्यतया, एक एप्लिकेशन को डेटा पढ़ने से पहले हर वातावरण में एक डेटावर्स एप्लिकेशन उपयोगकर्ता की आवश्यकता होती है। इसे प्रबंधन एप्लिकेशन के रूप में पंजीकृत करना इसे पूरे किरायेदार के पावर प्लेटफॉर्म वातावरण और डेटावर्स पर डेटा पढ़ने की पहुंच देता है, जो कैटो एजेंट कॉन्फ़िगरेशन और एजेंट सत्रों को उस पर-संवध्वियन सेटअप के बिना पढ़ने की अनुमति देता है। आप Azure Cloud Shell में PowerShell का उपयोग करके ऐप्लिकेशन पंजीकृत करते हैं, और पंजीकरण स्क्रिप्ट को आपके Microsoft Entra ID किरायेदार ID की आवश्यकता होती है।

किरायेदार आईडी प्राप्त करें

अपने Microsoft Entra ID किरायेदार ID प्राप्त करने के लिए:

1. Azure पोर्टल में, Microsoft Entra ID पर जाएँ।
2. अवलोकन पृष्ठ पर, मूलभूत जानकारी के तहत, किरायेदार ID की प्रतिलिपि बनाएँ। आप इस मान का उपयोग पंजीकरण स्क्रिप्ट में और बाद में कैटो में एकीकरण को समाप्त करने के लिए करते हैं।

पंजीकरण स्क्रिप्ट चलाएँ

प्रबंधन एप्लिकेशन पंजीकृत करने के लिए:

1. Azure पोर्टल में, क्लाउड शेल खोलें।
2. पावरशेल चुनें।
3. Copilot Studio के साथ संबद्ध सब्सक्रिप्शन चुनें और लागू करें क्लिक करें।
4. निम्नलिखित कमांड चलाएँ, और <YOUR-TENANT-ID> की जगह पहले कॉपी की गई किरायेदार आईडी का उपयोग करें:

$tenantId = "<YOUR-TENANT-ID>"

az login --scope "https://api.bap.microsoft.com/.default"
# लिंक का पालन करके और कोड दर्ज करके साइन इन प्रक्रिया पूरी करें, और प्रासंगिक सब्सक्रिप्शन का चयन करें

$token = az account get-access-token `
  --scope "https://api.bap.microsoft.com/.default" `
  --tenant $tenantId `
  --query accessToken -o tsv

$headers = @{
    "Authorization" = "Bearer $token"
    "Content-Type"  = "application/json"
}

$body = "{}"

$uri =
      "https://api.bap.microsoft.com/providers/" +
      "Microsoft.BusinessAppPlatform/adminApplications/" +
      "0f5bb78b-ad8f-454a-a7bc-3c6bb5b1e6c8?api-version=2020-10-01"

Invoke-RestMethod -Method Put -Uri $uri -Headers $headers -Body $body

Invoke-RestMethod कमांड रजिस्टर किया गया applicationId लौटाता है, जो प्रबंधन एप्लिकेशन के सफलतापूर्वक पंजीकृत होने की पुष्टि करता है:

एप्लिकेशनआईडी
-------------
0f5bb78b-ad8f-454a-a7bc-3c6bb5b1e6c8

चरण 3: एजेंट सत्रों को सक्षम करें

इस सेटिंग को सक्षम करने से कैटो को एक वातावरण में Copilot Studio एजेंटों के लिए एजेंट सत्रों को देखने की अनुमति मिलती है। किरायेदार में हर संबंधित वातावरण के लिए इसे सक्षम करें। वातावरण एक डेवलपर वातावरण नहीं हो सकता है। इस सेटिंग को सक्रिय करने के लिए पावर प्लेटफ़ॉर्म प्रशासक पहुंच आवश्यक है, या उस वातावरण में सिस्टम प्रशासक सुरक्षा भूमिका।

किसी वातावरण के लिए एजेंट सत्रों को सक्षम करने के लिए:

1. पावर प्लेटफ़ॉर्म प्रशासन केंद्र में, प्रबंधित करें > वातावरण पर जाएँ और वातावरण चुनें।
2. सेटिंग्स चुनें।
3. उत्पाद का विस्तार करें और विशेषताएं चुनें।
4. Copilot Studio एजेंटों के अंतर्गत, वार्तालाप प्रतिलेखों और उनके संबंधित मेटाडेटा को डेटावर्स में सहेजने की अनुमति दें (विस्तारित रिपोर्टिंग के लिए आवश्यक) सक्षम करें।

चरण 4: CMA में एकीकरण को पूरा करें

एकीकरण को पूरा करने के लिए, कैटो व्यवस्थापक पहले कॉपी की गई Microsoft Entra ID किरायेदार आईडी दर्ज करता है।

CMA में एकीकरण पूरा करने के लिए:

1. नेविगेशन मेनू से, एआई सुरक्षा > एकीकरण चुनें।
2. Copilot Studio टाइल पर, कनेक्ट पर क्लिक करें।
3. Azure AD किरायेदार आईडी क्षेत्र में, आपने जो किरायेदार आईडी कॉपी की थी उसे दर्ज करें।
4. कनेक्शन परीक्षण करें पर क्लिक करें। आप केवल परीक्षण के सफल होने के बाद एकीकरण को सहेज सकते हैं।
5. Save पर क्लिक करें।

डेटा ताज़ा

एकीकरण जोड़ने के बाद, कैटो तुरंत Copilot Studio से डेटा प्राप्त करता है, और फिर हर घंटे इसे दोबारा प्राप्त करता है। अपनी वातावरण में परिवर्तन के बाद CMA में अपडेट डेटा एक घंटे तक की उम्मीद करें।

अनुरोधित अनुमतियों की समीक्षा करें