इसके माध्यम से साझा किया गया

Microsoft एजेंट 365 SDK का उपयोग कर परीक्षण एजेंट

महत्त्वपूर्ण

Microsoft Agent 365 तक शीघ्र पहुँच प्राप्त करने के लिए आपको Frontier पूर्वावलोकन प्रोग्राम का भाग बनने की आवश्यकता है. फ्रंटियर आपको सीधे Microsoft के नवीनतम AI नवाचारों से जोड़ता है। फ्रंटियर पूर्वावलोकन आपके ग्राहक समझौतों की मौजूदा पूर्वावलोकन शर्तों के अधीन हैं। चूंकि ये सुविधाएँ अभी भी विकास में हैं, इसलिए उनकी उपलब्धता और क्षमताएं समय के साथ बदल सकती हैं।

परिनियोजन से पहले Agents Playground का उपयोग करके अपने एजेंट का स्थानीय रूप से परीक्षण करें। इस गाइड में आपके विकास परिवेश को स्थापित करना, प्रमाणीकरण को कॉन्फ़िगर करना और एजेंट प्लेग्राउंड परीक्षण टूल के साथ आपके एजेंट की कार्यक्षमता को मान्य करना शामिल है।

एक बार जब आपका एजेंट स्थानीय रूप से काम कर रहा हो, तो आप इसे Teams जैसे Microsoft 365 एप्लिकेशन में परीक्षण करने के लिए तैनात और प्रकाशित कर सकते हैं।

पूर्वावश्यकताएँ

आरंभ करने से पहले, सुनिश्चित करें कि आपके पास निम्नलिखित पूर्वापेक्षाएँ मौजूद हैं:

सामान्य पूर्वापेक्षाएँ

भाषा-विशिष्ट पूर्वापेक्षाएँ

  • पायथन 3.11+: python.org या माइक्रोसॉफ्ट स्टोर से डाउनलोड करें
  • यूवी पैकेज मैनेजर: यूवी का उपयोग करके यूवी स्थापित करें pip install uv
  • स्थापना सत्यापित करें.

एजेंट परीक्षण परिवेश कॉन्फ़िगर करें

इस अनुभाग में पर्यावरण चर सेट करना, आपके विकास वातावरण को प्रमाणित करना और परीक्षण के लिए आपके एजेंट 365 संचालित एजेंट को तैयार करना शामिल है।

अपने एजेंट परीक्षण परिवेश को सेट करना एक अनुक्रमिक वर्कफ़्लो का अनुसरण करता है:

  1. अपने परिवेश को कॉन्फ़िगर करें - अपनी परिवेश कॉन्फ़िगरेशन फ़ाइल बनाएँ या अद्यतन करें

  2. एलएलएम कॉन्फ़िगरेशन - एपीआई कुंजियाँ प्राप्त करें और OpenAI या Azure OpenAI सेटिंग्स कॉन्फ़िगर करें

  3. प्रमाणीकरण कॉन्फ़िगर करें - एजेंट प्रमाणीकरण सेट करें

  4. पर्यावरण चर संदर्भ - आवश्यक परिवेश चर कॉन्फ़िगर करें:

    1. प्रमाणीकरण चर
    2. MCP समापन बिंदु कॉन्फ़िगरेशन
    3. अवलोकन चर
    4. एजेंट अनुप्रयोग सर्वर कॉन्फ़िगरेशन

इन चरणों को पूरा करने के बाद, आप एजेंट प्लेग्राउंड में अपने एजेंट का परीक्षण शुरू करने के लिए तैयार हैं।

चरण 1: अपने परिवेश को कॉन्फ़िगर करें

अपनी कॉन्फ़िगरेशन फ़ाइल सेट करें:

cp .env.template .env

नोट

आवश्यक फ़ील्ड दिखाने वाले कॉन्फ़िगरेशन टेम्पलेट को ढूँढने के लिए Microsoft एजेंट 365 SDK नमूने देखें।

चरण 2: एलएलएम कॉन्फ़िगरेशन

स्थानीय परीक्षण के लिए OpenAI या Azure OpenAI सेटिंग्स कॉन्फ़िगर करें। किसी भी मॉडल पैरामीटर के साथ अपनी कॉन्फ़िगरेशन फ़ाइल में पूर्वापेक्षाओं से प्राप्त अपनी एपीआई कुंजियों और सेवा समापन बिंदुओं को जोड़ें।

अपनी .env फ़ाइल में जोड़ें:

# Replace with your actual OpenAI API key
OPENAI_API_KEY=

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_DEPLOYMENT=
AZURE_OPENAI_API_VERSION=

पायथन एलएलएम पर्यावरण चर

चर विवरण आवश्य उदाहरण
OPENAI_API_KEY OpenAI सेवा के लिए API कुंजी ओपनएआई के लिए sk-proj-...
AZURE_OPENAI_API_KEY Azure OpenAI सेवा के लिए API कुंजी Azure OpenAI के लिए a1b2c3d4e5f6...
AZURE_OPENAI_ENDPOINT Azure OpenAI सेवा समापन बिंदु URL Azure OpenAI के लिए https://your-resource.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT Azure OpenAI में परिनियोजन का नाम Azure OpenAI के लिए gpt-4
AZURE_OPENAI_API_VERSION Azure OpenAI के लिए API संस्करण Azure OpenAI के लिए 2024-02-15-preview

चरण 3: एजेंट पहचान प्रमाणीकरण के लिए प्रमाणीकरण मान कॉन्फ़िगर करें

अपने एजेंट ब्लूप्रिंट क्रेडेंशियल्स को पुनः प्राप्त करने के लिए A365 CLI a365 config display कमांड का उपयोग करें।

a365 config display -g

यह आदेश आपके एजेंट ब्लूप्रिंट कॉन्फ़िगरेशन को प्रदर्शित करता है। इसके निम्नलिखित मान हैं:

मान विवरण
agentBlueprintId आपके एजेंट की क्लाइंट आईडी
agentBlueprintClientSecret आपके एजेंट का ग्राहक रहस्य
tenantId आपकी Microsoft Entra टेनेंट ID

अपने एजेंट में एजेंट प्रमाणीकरण कॉन्फ़िगर करने के लिए इन मानों का उपयोग करें:

अपनी .env फ़ाइल में निम्न सेटिंग्स जोड़ें, प्लेसहोल्डर मानों को अपने वास्तविक क्रेडेंशियल्स से बदलें:

USE_AGENTIC_AUTH=true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID=<agentBlueprintId>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET=<agentBlueprintClientSecret>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID=<your-tenant-id>
चर विवरण आवश्य उदाहरण
USE_AGENTIC_AUTH एजेंट प्रमाणीकरण मोड सक्षम करें हां true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID एजेंट ब्लूप्रिंट क्लाइंट आईडी से a365 config display -g हां 12345678-1234-1234-1234-123456789abc
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET एजेंट ब्लूप्रिंट क्लाइंट सीक्रेट फ्रॉम a365 config display -g हां abc~123...
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID Microsoft Entra टेनेंट ID से a365 config display -g हां adfa4542-3e1e-46f5-9c70-3df0b15b3f6c

नोट

.NET के लिए, यह भी सुनिश्चित करें USE_AGENTIC_AUTH=true कि सेट किया launchSettings.json गया है (चरण 4 देखें: पर्यावरण चर संदर्भ)

चरण 4: पर्यावरण चर संदर्भ

निम्नलिखित आवश्यक परिवेश चर को कॉन्फ़िगर करके अपने परिवेश सेटअप को पूरा करें:

प्रमाणीकरण चर

ठीक से काम करने के लिए agentic प्रमाणीकरण के लिए आवश्यक प्रमाणीकरण हैंडलर सेटिंग्स कॉन्फ़िगर करें।

अपनी .env फ़ाइल में जोड़ें:

# Agentic Authentication Settings
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE=AgenticUserAuthorization
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES=https://graph.microsoft.com/.default
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME=service_connection

# Connection Mapping
CONNECTIONSMAP_0_SERVICEURL=*
CONNECTIONSMAP_0_CONNECTION=SERVICE_CONNECTION
चर विवरण आवश्य
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE प्रमाणीकरण हैंडलर प्रकार हां
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES Microsoft ग्राफ़ के लिए प्रमाणीकरण क्षेत्र हां
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME वैकल्पिक ब्लूप्रिंट कनेक्शन नाम हां
CONNECTIONSMAP_0_SERVICEURL कनेक्शन मैपिंग के लिए सेवा URL पैटर्न हां
CONNECTIONSMAP_0_CONNECTION मैपिंग के लिए कनेक्शन का नाम हां

MCP समापन बिंदु कॉन्फ़िगरेशन

MCP (मॉडल संदर्भ प्रोटोकॉल) समापन बिंदु कॉन्फ़िगरेशन यह निर्दिष्ट करने के लिए आवश्यक है कि आपके एजेंट को किस एजेंट को किस एजेंट से कनेक्ट करना चाहिए। जब आप टूलींग मैनिफ़ेस्ट जो आपके एजेंट के लिए टूलींग सर्वर को परिभाषित करता है, तो आपको MCP प्लेटफ़ॉर्म समापन बिंदु निर्दिष्ट करना होगा। यह समापन बिंदु निर्धारित करता है कि Microsoft 365 एकीकरण क्षमताओं के लिए MCP उपकरण सर्वर किस वातावरण (preprod, परीक्षण या उत्पादन) से कनेक्ट होते हैं।

अपनी .env फ़ाइल में जोड़ें:

# MCP Server Configuration
MCP_PLATFORM_ENDPOINT=<MCP endpoint>
चर विवरण आवश्य डिफ़ॉल्ट उदाहरण
MCP_PLATFORM_ENDPOINT MCP प्लेटफ़ॉर्म एंडपॉइंट URL (प्रीप्रोड, टेस्ट, या प्रोड) नहीं उत्पादन समापन बिंदु

महत्वपूर्ण: यदि निर्दिष्ट नहीं है, तो MCP_PLATFORM_ENDPOINT यह उत्पादन समापन बिंदु पर डिफ़ॉल्ट रूप से होता है।

अवलोकन चर

अपने एजेंट के लिए लॉगिंग और वितरित ट्रेसिंग को सक्षम करने के लिए इन आवश्यक चर को कॉन्फ़िगर करें। अवलोकन सुविधाओं और सर्वोत्तम प्रथाओं के बारे में अधिक जानें

नोट

अवलोकन विन्यास सभी भाषाओं में समान है।

चर विवरण डिफ़ॉल्ट उदाहरण
ENABLE_A365_OBSERVABILITY अवलोकन क्षमता को सक्षम/अक्षम करें false true
ENABLE_A365_OBSERVABILITY_EXPORTER अवलोकन सेवा के लिए निशान निर्यात करें false true
OBSERVABILITY_SERVICE_NAME ट्रेसिंग के लिए सेवा का नाम एजेंट का नाम my-agent-service
OBSERVABILITY_SERVICE_NAMESPACE सेवा बस नामस्थान agent365-samples my-company-agents

एजेंट अनुप्रयोग सर्वर कॉन्फ़िगरेशन

उस पोर्ट को कॉन्फ़िगर करें जहाँ आपका एजेंट अनुप्रयोग सर्वर चलता है. यह वैकल्पिक है और पायथन और जावास्क्रिप्ट एजेंटों पर लागू होता है।

अपनी .env फ़ाइल में जोड़ें:

# Server Configuration
PORT=3978
चर विवरण आवश्य डिफ़ॉल्ट उदाहरण
PORT पोर्ट नंबर जहां एजेंट सर्वर चलता है नहीं 3978 3978

निर्भरताएँ स्थापित करें और एजेंट अनुप्रयोग सर्वर प्रारंभ करें

एक बार जब आपका परिवेश कॉन्फ़िगर हो जाता है, तो आपको आवश्यक निर्भरताएँ स्थापित करनी होंगी और परीक्षण के लिए स्थानीय रूप से अपना एजेंट एप्लिकेशन सर्वर शुरू करना होगा।

निर्भरताएँ स्थापित करें.

uv pip install -e .

यह कमांड परिभाषित पैकेज निर्भरताओं pyproject.toml को पढ़ता है और उन्हें PyPI से इंस्टॉल करता है। स्क्रैच से एजेंट एप्लिकेशन बनाते समय, आपको अपनी निर्भरता को परिभाषित करने के लिए एक pyproject.toml फ़ाइल बनाने की आवश्यकता होती है। नमूना रिपॉजिटरी से नमूना एजेंटों के पास पहले से ही इन पैकेजों को परिभाषित किया गया है। आप उन्हें आवश्यकतानुसार जोड़ या अपडेट कर सकते हैं।

एजेंट अनुप्रयोग सर्वर प्रारंभ करें

python <main.py>

अपनी मुख्य पायथन फ़ाइल के नाम से बदलें <main.py> जिसमें आपके एजेंट एप्लिकेशन के लिए प्रवेश बिंदु है (उदाहरण के लिए, start_with_generic_host.py, , app.pyया )।main.py

या यूवी का उपयोग करना:

uv run python <main.py>

आपका एजेंट सर्वर अब चल रहा होना चाहिए और एजेंट प्लेग्राउंड या Microsoft 365 अनुप्रयोगों से अनुरोध प्राप्त करने के लिए तैयार होना चाहिए।

एजेंट खेल के मैदान में परीक्षण एजेंट

एजेंट प्लेग्राउंड एक स्थानीय परीक्षण उपकरण है जो पूर्ण टैनेंट सेटअप की आवश्यकता के बिना Microsoft 365 वातावरण का अनुकरण करता है। यह आपके एजेंट के तर्क और उपकरण आह्वानों को मान्य करने का सबसे तेज़ तरीका है। अधिक जानकारी के लिए, एजेंट के साथ परीक्षण करें खेल का मैदान.

एक नया टर्मिनल खोलें (विंडोज़ पर पावरशेल) और एजेंट खेल का मैदान शुरू करें:

agentsplayground

यह एजेंट प्लेग्राउंड इंटरफ़ेस के साथ एक वेब ब्राउज़र खोलता है। यह टूल एक चैट इंटरफ़ेस प्रदर्शित करता है जहाँ आप अपने एजेंट को संदेश भेज सकते हैं।

बुनियादी परीक्षण

यह सत्यापित करके प्रारंभ करें कि आपका एजेंट ठीक से कॉन्फ़िगर किया गया है। एजेंट को एक संदेश भेजें:

What can you do?

एजेंट को आपके एजेंट के सिस्टम प्रॉम्प्ट और क्षमताओं के आधार पर उन निर्देशों के साथ उत्तर देना चाहिए जिनके साथ इसे कॉन्फ़िगर किया गया है। यह पुष्टि करता है कि:

  • आपका एजेंट ठीक से चल रहा है
  • एजेंट संदेशों को संसाधित कर सकता है और जवाब दे सकता है
  • एजेंट खेल का मैदान और आपके एजेंट के बीच संचार काम कर रहा है

परीक्षण उपकरण आमंत्रण

अपने MCP उपकरण सर्वर को कॉन्फ़िगर toolingManifest.json करने के बाद (सेटअप निर्देशों के लिए टूलींग देखें), इस तरह के उदाहरणों के साथ उपकरण आह्वानों का परीक्षण करें:

सबसे पहले, सत्यापित करें कि कौन से उपकरण उपलब्ध हैं:

List all tools I have access to

फिर विशिष्ट उपकरण आह्वानों का परीक्षण करें:

मेल उपकरण

Send email to your-email@example.com with subject "Test" and message "Hello from my agent"

अपेक्षित प्रतिक्रिया: एजेंट मेल MCP सर्वर का उपयोग करके एक ईमेल भेजता है और पुष्टि करता है कि संदेश भेजा गया था।

कैलेंडर उपकरण

List my calendar events for today

अपेक्षित प्रतिक्रिया: एजेंट वर्तमान दिन के लिए आपके कैलेंडर ईवेंट को पुनः प्राप्त करेगा और प्रदर्शित करेगा।

SharePoint उपकरण

List all SharePoint sites I have access to

अपेक्षित प्रतिक्रिया: एजेंट SharePoint क्वेरी करता है और उन साइट्स की सूची देता है जिन तक आपकी पहुँच है.

आप टूल इनवॉकेशन देख सकते हैं:

  • चैट विंडो - एजेंट की प्रतिक्रिया और किसी भी टूल कॉल को देखें
  • लॉग पैनल - उपकरण मापदंडों और प्रतिक्रियाओं सहित विस्तृत गतिविधि जानकारी देखें

अधिसूचना गतिविधियों के साथ परीक्षण करें

स्थानीय विकास के दौरान, आप एजेंट प्लेग्राउंड में कस्टम गतिविधियों का अनुकरण करके अधिसूचना परिदृश्यों का परीक्षण कर सकते हैं। यह आपको अपने एजेंट की अधिसूचना हैंडलिंग को उत्पादन में तैनात करने से पहले सत्यापित करने की अनुमति देता है।

अधिसूचना गतिविधियों का परीक्षण करने से पहले, सुनिश्चित करें कि आपके पास है:

सूचनाओं को सही ढंग से काम करने के लिए उचित उपकरण कॉन्फ़िगरेशन और अधिसूचना सेटअप दोनों की आवश्यकता होती है। आप कस्टम गतिविधि सुविधा का उपयोग करके ईमेल सूचनाओं या Word टिप्पणियों जैसे परिदृश्यों का परीक्षण कर सकते हैं।

कस्टम गतिविधियाँ भेजने के लिए:

  1. अपना एजेंट और एजेंट खेल का मैदान शुरू करें
  2. Agents Playground में, Mock an Activity>कस्टम गतिविधि पर नेविगेट करें
  3. गतिविधि से कॉपी करें conversationId (हर बार एजेंट प्लेग्राउंड को पुनरारंभ करने पर वार्तालाप आईडी बदल जाती है)
  4. अपनी कस्टम गतिविधि JSON पेस्ट करें और आपके द्वारा कॉपी की गई वार्तालाप ID के साथ फ़ील्ड को personal-chat-id अपडेट करें। ईमेल सूचना उदाहरण देखें
  5. गतिविधि जोड़ें चुनें.
  6. चैट वार्तालाप और लॉग पैनल दोनों में परिणाम देखें

ईमेल सूचना

यह एजेंट को भेजे गए ईमेल का अनुकरण करता है। प्लेसहोल्डर मानों को अपने वास्तविक एजेंट विवरण से बदलें:

{
  "type": "message",
  "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "timestamp": "2025-09-24T17:40:19+00:00",
  "serviceUrl": "http://localhost:56150/_connector",
  "channelId": "agents",
  "name": "emailNotification",
  "from": {
    "id": "manager@contoso.com",
    "name": "Agent Manager",
    "role": "user"
  },
  "recipient": {
    "id": "agent@contoso.com",
    "name": "Agent",
    "agenticUserId": "<your-agentic-user-id>",
    "agenticAppId": "<your-agent-app-id>",
    "tenantId": "<your-tenant-id>"
  },
  "conversation": {
    "conversationType": "personal",
    "tenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "id": "personal-chat-id"
  },
  "membersAdded": [],
  "membersRemoved": [],
  "reactionsAdded": [],
  "reactionsRemoved": [],
  "locale": "en-US",
  "attachments": [],
  "entities": [
    {
      "id": "email",
      "type": "productInfo"
    },
    {
      "type": "clientInfo",
      "locale": "en-US",
      "timezone": null
    },
    {
      "type": "emailNotification",
      "id": "bbbbbbbb-1111-2222-3333-cccccccccccc",
      "conversationId": "personal-chat-id",
      "htmlBody": "<body dir=\"ltr\">\n<div class=\"elementToProof\" style=\"font-family: Aptos, Aptos_EmbeddedFont, Aptos_MSFontService, Calibri, Helvetica, sans-serif; font-size: 12pt; color: rgb(0, 0, 0);\">\nYour email message content here</div>\n\n\n</body>"
    }
  ],
  "channelData": {
    "tenant": {
      "id": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
    }
  },
  "listenFor": [],
  "textHighlights": []
}

अवलोकन लॉग देखें

स्थानीय विकास के दौरान अवलोकन लॉग देखने के लिए, अपने एजेंट को ऑब्जर्वेबिलिटी कोड के साथ इंस्ट्रूमेंट करें (कोड उदाहरणों के लिए ऑब्जर्वेबिलिटी देखें) और ऑब्जर्वेबिलिटी वेरिएबल्स में वर्णित परिवेश चर को कॉन्फ़िगर करें। एक बार कॉन्फ़िगर होने के बाद, कंसोल में रीयल-टाइम ट्रेस दिखाई देते हैं:

  • एजेंट आह्वान निशान
  • उपकरण निष्पादन विवरण
  • एलएलएम अनुमान कॉल
  • इनपुट और आउटपुट संदेश
  • टोकन उपयोग
  • प्रतिक्रिया समय
  • त्रुटि जानकारी

ये लॉग आपको समस्याओं को डीबग करने, एजेंट व्यवहार को समझने और प्रदर्शन को अनुकूलित करने में मदद करते हैं।

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

यह अनुभाग उन सामान्य समस्याओं का समाधान प्रदान करता है जिनका सामना आप स्थानीय स्तर पर अपने एजेंट का परीक्षण करते समय कर सकते हैं।

कनेक्शन और पर्यावरण के मुद्दे

ये समस्याएँ नेटवर्क कनेक्टिविटी, पोर्ट विरोध, और पर्यावरण सेटअप समस्याओं से संबंधित हैं जो आपके एजेंट को ठीक से संचार करने से रोक सकते हैं।

एजेंट खेल का मैदान कनेक्शन समस्याएँ

लक्षण: एजेंट खेल का मैदान आपके एजेंट से कनेक्ट नहीं हो सकता

समाधान:

  • सत्यापित करें कि आपका एजेंट सर्वर चल रहा है
  • जांचें कि पोर्ट नंबर आपके एजेंट और एजेंट प्लेग्राउंड के बीच मेल खाते हैं
  • सुनिश्चित करें कि स्थानीय कनेक्शन को अवरुद्ध करने वाले कोई फ़ायरवॉल नियम नहीं हैं
  • एजेंट और एजेंट खेल का मैदान दोनों को पुनरारंभ करने का प्रयास करें

पुराना एजेंट खेल का मैदान संस्करण

लक्षण: Agents Playground में अनपेक्षित त्रुटियाँ या अनुपलब्ध सुविधाएँ

समाधान: एजेंट्स खेल का मैदान अनइंस्टॉल और पुनर्स्थापित करें:

winget uninstall agentsplayground
winget install agentsplayground

पोर्ट संघर्ष

लक्षण: पोर्ट को इंगित करने में त्रुटि पहले से ही उपयोग में है

समाधान:

  • अपने एजेंट के किसी भी अन्य उदाहरण को रोकें
  • अपने कॉन्फ़िगरेशन में पोर्ट बदलें
  • पोर्ट का उपयोग करके किसी भी प्रक्रिया को समाप्त करें:
# Windows PowerShell
Get-Process -Id (Get-NetTCPConnection -LocalPort <port>).OwningProcess | Stop-Process

डेवलपरMCPServer नहीं जोड़ सकते

लक्षण: VS कोड में DeveloperMCPServer जोड़ने का प्रयास करते समय त्रुटि

समाधान: बंद करें और Visual Studio कोड को फिर से खोलें, उसके बाद सर्वर को फिर से जोड़ने का प्रयास करें।

प्रमाणीकरण समस्याएँ

ये समस्याएँ तब होती हैं जब आपका एजेंट Microsoft 365 सेवाओं के साथ ठीक से प्रमाणित नहीं कर सकता है या जब क्रेडेंशियल्स की समय सीमा समाप्त हो गई है या गलत कॉन्फ़िगर किया गया है।

बियरर टोकन की समय सीमा समाप्त हो गई

लक्षण: प्रमाणीकरण त्रुटियाँ या 401 अनधिकृत प्रतिसाद

समाधान: बियरर टोकन लगभग 1 घंटे के बाद समाप्त हो जाते हैं। एक नया टोकन प्राप्त करें और अपना कॉन्फ़िगरेशन अपडेट करें।

पायथन में एजेंट प्रमाणीकरण त्रुटियाँ

लक्षण: एजेंट इंस्टेंस टोकन प्राप्त करने में त्रुटि

समाधान: अपने .envमें सेटिंग सत्यापित ALT_BLUEPRINT_NAME करें:

# Change from:
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=ServiceConnection

# To:
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=SERVICE_CONNECTION

उपकरण और अधिसूचना संबंधी समस्याएं

इन समस्याओं में उपकरण आह्वान, MCP सर्वर इंटरैक्शन और अधिसूचना वितरण के साथ समस्याएँ शामिल हैं।

ईमेल प्राप्त नहीं हुआ

लक्षण: एजेंट इंगित करता है कि ईमेल भेजा गया था, लेकिन आपको वह प्राप्त नहीं होता है

समाधान:

  • अपने जंक/स्पैम फ़ोल्डर की जाँच करें
  • ईमेल डिलीवरी में कुछ मिनट की देरी हो सकती है - 5 मिनट तक प्रतीक्षा करें
  • सत्यापित करें कि प्राप्तकर्ता का ईमेल पता सही है
  • ईमेल भेजने के दौरान किसी भी त्रुटि के लिए एजेंट लॉग की जाँच करें

शब्द टिप्पणी प्रतिक्रियाएँ काम नहीं कर रही हैं

ज्ञात समस्या: सूचना सेवा वर्तमान में Word टिप्पणियों के लिए सीधे प्रतिसाद नहीं दे सकता। यह कार्यक्षमता विकसित की जा रही है।

सहायता प्राप्त करना

यदि आप इस समस्या निवारण अनुभाग में शामिल नहीं समस्याओं का सामना करते हैं, तो इन संसाधनों का अन्वेषण करें:

Microsoft एजेंट 365 SDK रिपॉजिटरी

अधिक समर्थन

अगले चरण

अब जब आपने स्थानीय रूप से अपने एजेंट का सफलतापूर्वक परीक्षण कर लिया है, तो आप इसे Azure पर तैनात करने और इसे Microsoft 365 पर प्रकाशित करने के लिए तैयार हैं:

  • एजेंटों को परिनियोजित और प्रकाशित करें: अपने एजेंट को Azure Web App पर परिनियोजित करने और उसे Microsoft व्यवस्थापन केंद्र पर प्रकाशित करने का तरीका जानें, जिससे यह आपके संगठन के लिए Microsoft 365 में खोजने और किराए पर लेने के लिए उपलब्ध हो सके.
  • Last updated on