Copilot Studio के लिए ऑब्ज़रवेबिलिटी एकीकरण

Microsoft Copilot Studio एजेंट स्वचालित रूप से टेलीमेट्री Microsoft Agent 365 ऑब्जर्वेबिलिटी बैकएंड को प्रेषित करते हैं—किसी मैन्युअल SDK इंस्ट्रूमेंटेशन की आवश्यकता नहीं है। यह स्वचालित ऑब्ज़रवेबिलिटी Microsoft 365 व्यवस्थापन केंद्र, Microsoft Defender और Microsoft Purview में एजेंट गतिविधि, प्रदर्शन और त्रुटियों में दृश्यता प्रदान करती है।

यह लेख बताता है कि Copilot Studio ऑब्ज़रवेबिलिटी को स्वचालित रूप से कैसे संभालता है और टेलीमेट्री डेटा कहां देखना है।

नोट

सामान्य Agent 365 अवलोकन अवधारणाओं और प्रो-कोड एजेंटों के लिए मैनुअल इंस्ट्रूमेंटेशन के बारे में जानने के लिए एजेंट अवलोकन देखें। यह लेख Copilot Studio एजेंटों के लिए स्वचालित अवलोकन पर केंद्रित है।

स्वचालित अवलोकन

Copilot Studio एजेंट, Agent 365 अवलोकन ढांचे में स्वचालित रूप से भाग लेते हैं:

  • कोई SDK आवश्यक नहीं: उन pro-कोड एजेंटों के विपरीत जिन्हें OpenTelemetry SDK की इंस्टॉलेशन और कॉन्फ़िगरेशन की आवश्यकता होती है, Copilot Studio प्लेटफ़ॉर्म रनटाइम में सभी टेलीमेट्री डेटा का उत्सर्जन स्वयं प्रबंधित करता है।
  • ओपनटेलीमेट्री अनुपालन: टेलीमेट्री OpenTelemetry सिमेंटिक सम्मेलनों का पालन करती है, जिससे प्रो-कोड एजेंटों और अन्य प्लेटफार्मों के साथ संगति सुनिश्चित होती है।
  • स्वचालित अंतर्ग्रहण: टेलीमेट्री बिना किसी अतिरिक्त कॉन्फ़िगरेशन के Agent 365 ऑब्ज़र्वेबिलिटी बैकएंड में प्रवाहित होती है।
  • तत्काल उपलब्धता: ऑब्जर्वेबिलिटी डेटा एजेंट गतिविधि के कुछ ही मिनटों के भीतर Microsoft 365 व्यवस्थापन केंद्र में दिखाई देता है।

यह स्वचालन केंद्रीकृत निगरानी, सुरक्षा विश्लेषण और अनुपालन रिपोर्टिंग को सक्षम बनाता है, वह भी डेवलपर प्रयास के बिना।

क्या टैलीमेट्री कैप्चर किया गया है

Copilot Studio स्वचालित रूप से जनरेटिव AI स्पैन के लिए दो OpenTelemetry सिमेंटिक कन्वेंशन का उत्सर्जन करता है:

नोट

  • टेलीमेट्री केवल प्रमाणित सत्रों के लिए कैप्चर की जाती है
  • टेलीमेट्री में बहु-किरायेदार एजेंटों को शामिल नहीं किया जाता है
  • 42 वर्णों से अधिक लंबे नाम वाले एजेंट लॉग नहीं किए जाते हैं
  • बड़े इनपुट और आउटपुट स्वचालित रूप से निम्नलिखित क्षेत्रों में संक्षिप्त कर दिए जाते हैं:
    • आउटपुट संदेश
    • टूल आर्ग्युमेंट
    • उपकरण प्रतिक्रिया (gen_ai.event.content)
    • एजेंट विवरण

एजेंट को इनवोक करें

एजेंट इनवोकेशन गतिविधि को कैप्चर करता है:

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

उदाहरण घटना

{
  "Name": "InvokeAgent",
  "Attributes": {
    "gen_ai.operation.name": "invoke_agent",
    "gen_ai.agent.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "gen_ai.agent.name": "customer-support-agent",
    "gen_ai.agent.applicationid": "12345678-90ab-cdef-1234-567890abcdef",
    "gen_ai.agent.platformid": "Default-11111111-2222-3333-4444-555555555555_01234567-89ab-cdef-0123-456789abcdef",
    "gen_ai.agent.type": "CopilotStudio",
    "tenant.id": "11111111-2222-3333-4444-555555555555",
    "gen_ai.channel.name": "Copilot Studio Test Pane",
    "gen_ai.execution.type": "HumanToAgent",
    "gen_ai.conversation.id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "gen_ai.caller.id": "99999999-8888-7777-6666-555555555555",
    "gen_ai.caller.upn": "alex.smith@contoso.com",
    "gen_ai.caller.name": "Alex Smith",
    "gen_ai.caller.client.ip": "192.168.1.100",
    "gen_ai.caller.tenantid": "11111111-2222-3333-4444-555555555555",
    "gen_ai.input.messages": "What's the weather in Seattle?",
    "env.id": "Default-11111111-2222-3333-4444-555555555555"
  },
  "StartTimeUnixNano": 1700000000000000000,
  "EndTimeUnixNano": 0,
  "SpanId": "aaaa1111-bbbb-2222-cccc-333333333333"
}

आउटपुट संदेश

एजेंट के आउटपुट को कैप्चर करता है:

  • आउटपुट संदेश: उपयोगकर्ता के लिए एजेंट का प्रत्युत्तर (संवेदनशील डेटा हटा दिया गया)

नोट

एजेंट कॉल या टूल निष्पादन से उत्पन्न त्रुटि संदेशों को आउटपुट संदेश के रूप में लॉग किए जाता है।

नीचे एक और उदाहरण इवेंट दिया गया है।

{
  "Name": "OutputMessages",
  "Attributes": {
    "gen_ai.operation.name": "output_messages",
    "gen_ai.agent.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "gen_ai.agent.name": "customer-support-agent",
    "gen_ai.agent.applicationid": "12345678-90ab-cdef-1234-567890abcdef",
    "gen_ai.agent.platformid": "Default-11111111-2222-3333-4444-555555555555_01234567-89ab-cdef-0123-456789abcdef",
    "gen_ai.agent.type": "CopilotStudio",
    "tenant.id": "11111111-2222-3333-4444-555555555555",
    "gen_ai.output.messages": "The current weather in **Seattle, WA** is:\n\n- **Temperature:** 18°C (feels like 17°C)...",
    "gen_ai.conversation.id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "gen_ai.channel.name": "Copilot Studio Test Pane",
    "gen_ai.caller.id": "99999999-8888-7777-6666-555555555555",
    "gen_ai.caller.upn": "alex.smith@contoso.com",
    "gen_ai.caller.name": "Alex Smith",
    "gen_ai.caller.client.ip": "192.168.1.100",
    "gen_ai.caller.tenantid": "11111111-2222-3333-4444-555555555555",
    "env.id": "Default-11111111-2222-3333-4444-555555555555"
  },
  "StartTimeUnixNano": 0,
  "EndTimeUnixNano": 1700000005000000000,
  "SpanId": "bbbb2222-cccc-3333-dddd-444444444444",
  "ParentSpanId": "aaaa1111-bbbb-2222-cccc-333333333333"
}

टूल निष्पादन

जब आपका एजेंट कनेक्टर्स या क्रियाओं का उपयोग करता है, तब उपकरण निष्पादन दर्ज किया जाता है:

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

नीचे एक और उदाहरण इवेंट दिया गया है।

{
  "Name": "ExecuteTool",
  "Attributes": {
    "gen_ai.operation.name": "execute_tool",
    "gen_ai.agent.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "gen_ai.agent.name": "customer-support-agent",
    "gen_ai.agent.applicationid": "12345678-90ab-cdef-1234-567890abcdef",
    "gen_ai.agent.platformid": "Default-11111111-2222-3333-4444-555555555555_01234567-89ab-cdef-0123-456789abcdef",
    "gen_ai.agent.type": "CopilotStudio",
    "tenant.id": "11111111-2222-3333-4444-555555555555",
    "gen_ai.tool.name": "msnweather:CurrentWeather",
    "gen_ai.tool.arguments": "{\"Location\":\"Seattle, WA\",\"units\":\"C\"}",
    "gen_ai.tool.call.id": "/providers/Microsoft.PowerApps/apis/shared_msnweather:CurrentWeather:abcdef12-3456-7890-abcd-ef1234567890",
    "gen_ai.tool.type": "Power Platform Connector",
    "gen_ai.conversation.id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "gen_ai.event.content": "{ /* tool execution results */ }",
    "gen_ai.channel.name": "Copilot Studio Test Pane",
    "gen_ai.caller.id": "99999999-8888-7777-6666-555555555555",
    "gen_ai.caller.upn": "alex.smith@contoso.com",
    "gen_ai.caller.name": "Alex Smith",
    "gen_ai.caller.client.ip": "192.168.1.100",
    "gen_ai.caller.tenantid": "11111111-2222-3333-4444-555555555555",
    "env.id": "Default-11111111-2222-3333-4444-555555555555"
  },
  "StartTimeUnixNano": 1700000002000000000,
  "EndTimeUnixNano": 0,
  "SpanId": "cccc3333-dddd-4444-eeee-555555555555",
  "ParentSpanId": "aaaa1111-bbbb-2222-cccc-333333333333"
}

सभी टेलीमेट्री गोपनीयता सीमाओं का सम्मान करती है। संदेशों और टूल इनपुट और आउटपुट में संवेदनशील उपयोगकर्ता डेटा अप्रकट कर दिया जाता है और प्रशासकों के लिए दृश्य नहीं होता। टेलीमेट्री का उपयोग आंतरिक सुरक्षा निगरानी और अनुपालन उद्देश्यों के लिए किया जाता है।

अगले चरण

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