Agent 365 समस्या निवारण मार्गदर्शिका

संपूर्ण Agent 365 विकास जीवनचक्र के दौरान समस्याओं का निदान और समाधान करने के लिए इस गाइड का उपयोग करें। समस्या निवारण के लिए अपने प्रारंभिक बिंदु के रूप में इस आलेख का उपयोग करें, और फिर विस्तृत समाधान के लिए विशिष्ट अनुभागों पर जाएँ।

समस्या निवारण चरण

इस तालिका में प्रत्येक लिंक विशिष्ट क्षेत्रों के लिए समस्या निवारण चरण प्रदान करता है। सामग्री को Agent 365 SDK विकास जीवनचक्र के चरण के अनुसार समूहीकृत किया गया है।

चरण समस्या निवारण सामग्री
एजेंट बिल्ड करें और चलाएं एजेंट 365 CLI
एजेंट 365 सीएलआई के लिए कस्टम क्लाइंट ऐप पंजीकरण
मॉक टूलिंग सर्वर
एजेंट अवलोकनीयता
एजेंट्स का परीक्षण
Dev Tunnel का उपयोग करके एजेंटों का परीक्षण करें
सामग्री जोड़ें और प्रबंधित करें
एजेंट ब्लूप्रिंट सेटअप करें एजेंट ब्लूप्रिंट सेटअप करें
उपयोग करें एजेंट को Azure से तैनात करें
Amazon Web Services (AWS) में एजेंट तैनात करें
Google क्लाउड प्लेटफ़ॉर्म (GCP) पर एजेंट परिनियोजित करें
Microsoft 365 व्यवस्थापन केंद्र पर एजेंट प्रकाशित करें एजेंट को Microsoft व्यवस्थापन केंद्र पर प्रकाशित करें
एजेंट इंस्टेंस बनाएँ एजेंट इंस्टेंस बनाएँ

डायग्नोस्टिक कमांड संदर्भ

विशिष्ट समस्याओं में गोता लगाने से पहले, अपने Agent 365 सेटअप की वर्तमान स्थिति की जांच करने के लिए इन कमांड का उपयोग करें:

सीएलआई और कॉन्फ़िगरेशन की जाँच करें

इन कमांड का उपयोग अपने CLI और कॉन्फ़िगरेशन को सत्यापित करने के लिए करें।

# Verify CLI is installed and check version
a365 --version

# Display current configuration
Get-Content a365.config.json | ConvertFrom-Json

# Display generated configuration (after setup)
Get-Content a365.generated.config.json | ConvertFrom-Json

Azure संसाधनों की जाँच करें

Azure संसाधनों और ऐप स्थिति का निरीक्षण करने के लिए इन कमांड का उपयोग करें।

# Set these variables with appropriate data for your app
$resource-group = <your-resource-group>
$app-name = <your-app-name>

# Authenticate with Azure
az login

# List resources in your resource group
az resource list --resource-group $resource-group --output table

# Check Web App status
az webapp show --name $app-name --resource-group $resource-group --query state

# View Web App logs (real-time)
az webapp log tail --name $app-name --resource-group $resource-group

एजेंट ब्लूप्रिंट को सत्यापित करें

पुष्टि करें कि आपका एजेंट ब्लूप्रिंट मौजूद है और सही ढंग से कॉन्फ़िगर किया गया है।

# Check if blueprint ID is set
Get-Content a365.generated.config.json | Select-String "agentBlueprintId"

Microsoft Entra में ब्लूप्रिंट सत्यापित करें

  1. https://entra.microsoft.com > ऐप पंजीकरण> सभी अनुप्रयोग पर जाएं।
  2. अपने agentBlueprintId की खोज करें।

रोकथाम के लिए सर्वोत्तम अभ्यास

इन अनुशंसाओं का उपयोग करें ताकि सामान्य समस्याओं को रोका जा सके और समस्या निवारण को सुव्यवस्थित किया जा सके।

शुरू करने से पहले

पूर्वापेक्षाएँ चेकलिस्ट:

✅ .NET 8.0 SDK स्थापित किया गया
✅ Azure CLI स्थापित और प्रमाणित किया गया।
✅ आवश्यक Entra अनुमतियाँ असाइन की गईं
✅कस्टम क्लाइंट ऐप बनाया और कॉन्फ़िगर किया गया
✅ Microsoft Agent 365 Frontier के लिए टेनेंट सक्षम किया गया है

सत्यापन आदेश:

# Check .NET
dotnet --version

# Check Azure CLI
az --version
az account show

# Check CLI installation
a365 --version

विकास के दौरान

अपना कॉन्फ़िगरेशन सहेजें

  • कॉन्फ़िगरेशन फ़ाइलों का बैकअप रखें।
  • अपने सेटअप विकल्पों का दस्तावेजीकरण करें।
  • जेनरेट की गई ID (जैसे ब्लूप्रिंट ID और प्रबंधित पहचान ID) सुरक्षित रखें।

CLI को अपडेट रखें:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

वृद्धिशील रूप से परीक्षण करें:

  • प्रत्येक प्रमुख चरण के बाद परीक्षण करें।
  • आगे बढ़ने से पहले सफलता की पुष्टि करें।
  • कार्यरत विन्यास सुरक्षित रखें।

तैनाती से पहले

पूर्व-परिनियोजन चेकलिस्ट:

✅ एजेंट स्थानीय रूप से एजेंट्स प्लेग्राउंड के साथ काम करता है।
✅ सभी पर्यावरण वेरिएबल्स प्रलेखित किए गए हैं।
✅ कॉन्फ़िगरेशन फ़ाइलें स्रोत नियंत्रण में जमा की गई हैं
✅ सभी MCP सर्वर कॉन्फ़िगर किए गए और परीक्षण किए गए हैं।
✅ ऑब्ज़र्वेबिलिटी सक्षम की गई और सत्यापित की गई है।

अतिरिक्त मदद लें

नमूना कोड की समीक्षा करने, समस्याओं की रिपोर्ट करने या मौजूदा समस्याओं को खोजने के लिए इन रिपॉजिटरीज़ का उपयोग करें:

  • पिछली बार को अपडेट किया गया