إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
هذا هو المعيار القياسي للسمة بصفة المستخدم في خط أنابيب الإدخال الخاص بالعميل 365. كل امتداد يستهلكه العامل 365 - سواء كان يصدر من Microsoft OpenTelemetry Distro، أو Agent 365 SDK، أو يرسل عبر direct OTel - يجب أن يتوافق معه. كل إدخال يسرد أنواع العمليات التي تنطبق عليها السمة، وما إذا كانت إلزامية، واسم الحقل الذي تظهر فيه قيمتك لاستعلامات الصيد المتقدمة (حيث توجد واحدة)، والتأثير إذا تخطيتها.
إذا كنت تستخدم SDK أو التوزيعة، فإن SDK يرسل هذه الخصائص نيابة عنك، وقسم اختيار القيم ينطبق فقط عندما تحتاج إلى تجاوز الوضع الافتراضي. إذا كنت على مسار OTel المباشر، فإنك ترسل كل سمة يدويا؛ لكيفية تجميعها في طلب، راجع دليل التكامل.
Attribute table
جميع القيم ترسل كالتالي stringValue - يجب أن تكون "42" أعداد الرموز (ليس 42)؛ يجب أن تكون "443" المنافذ (ليست 443).
عملية الأسطورة.IA = invoke_agent، ET = execute_tool، CH = chat، OM = output_messages، All = ينطبق على كل عملية.
Required legend.
- M: mandatory.
- M*¹: إلزامي فقط للوكلاء المتجسدين (للوكيل حساب مستخدم معرف عامل Entra خاص به).
- M*²: إلزامي فقط للمكالمات بين الوكلاء.
-
M*³: إلزامي فقط للامتدادات غير الجذرية. الجذر
invoke_agentليس له والد. - O*⁴: اختياري، ولا يعني إلا عندما تكون حالة الامتداد هي الخطأ.
- O: optional.
- لا ممن: لا تصدر الطلقات. العميل 365 يملأ تلقائيا.
عمود "حقل RawEventData" يذكر مفتاح JSON بداخله CloudAppEvents.RawEventData يقوم استعلام الصيد المتقدم القانوني في التحقق من الابتعاد (Verifying ingestion ). الخلية الفارغة تعني أن السمة مكشوفة not في CloudAppEvents اليوم—يجب أن تصدرها (حسب عمود Required) لأن Agent 365 يستخدمها للاستدعاء، وحل الوالد، وعرض نشاط الوكيل في Microsoft Defender، لكنها ليست قابلة للاستعلام المباشر من Microsoft Defender البحث المتقدم اليوم.
Note
يقوم الوكيل 365 بملء حقول السجلات الثابتة تلقائيا (Id, RecordType, Workload, UserType, Version) ومعرفات الطلب/الاستجابة المولدة.
| Attribute | Applies to | Required | RawEventData field | ملاحظات / تأثير إذا تم النقص |
|---|---|---|---|---|
gen_ai.operation.name |
All | M | Operation |
واحد من invoke_agent، ، ، execute_tool. chatoutput_messages كان المسافة تنخفض إذا اختفت أو لم تتعرف عليها. |
microsoft.tenant.id |
All | M | OrganizationId |
الرابط {tenantId} موثوق. إذا قمت بتعيين هذا ولم يوافق البرنامج، يتم رفض الطلب (403). |
gen_ai.agent.id |
All | M |
TargetAgentId (IA، أيضا أعلى مستوى AgentId)؛ AgentId (ET، CH) |
تطبيق تطبيق الاتصال. يجب أن يتطابق الرابط {agentId} مع التطبيق المصادق. عدم التطابق يعود إلى 403. |
gen_ai.agent.name |
All | M |
TargetAgentName (IA); AgentName (ET، CH) |
Defender / Admin Center يعرض واجهة المستخدم الراقصة الخام بدلا من الاسم إذا كان مفقودا. |
microsoft.a365.agent.blueprint.id |
All | M |
TargetAgentBlueprintID (IA); AgentBlueprintId (ET، CH) |
المخطط تم تطبيقه. بالنسبة لتطبيقات Entra القياسية التي لا تحتوي على مخطط، أعد استخدام معرف التطبيق الخاص بالوكيل. تتوقف تركيبات المخططات في مركز الإدارة بخلاف ذلك. |
gen_ai.agent.description |
All | O | -- | عرض التفاصيل في مركز الإدارة فارغ للوكيل. |
gen_ai.agent.type |
All | O |
PlatformTargetAgentType (IA); PlatformAgentType (بتوقيت الشرق)؛ CopilotEventData.PlatformAgentType (CH) |
تسمية لنظام الهوية الخاص بك، مع microsoft.a365.agent.platform.id موعد عندما لا يكون لدى الوكيل تسجيل إنترا. النص الحر؛ اختر قيمة تحدد نظام هويتك بشكل فريد. احذف عندما يكون لدى الوكيل تسجيل إنترا—الوكيل 365 يصنف تلقائيا. لا تستخدم القيم المحجوزة Microsoft (انظر اختيار القيم). |
microsoft.a365.agent.platform.id |
All | O |
PlatformTargetAgentId (IA، أيضا أعلى مستوى AlternateId)؛ PlatformAgentId (ET، CH) |
هوية العميل الفريدة في نظام الهوية غير التابع لإنترا الخاص بك. Free-form text. اجمعها معا مع gen_ai.agent.type. احذف ذلك عندما يكون لدى الوكيل تسجيل إنترا. انظر اختيار القيم. |
gen_ai.conversation.id |
All | M |
ConversationId (IA، شرق إنجلس)؛ CopilotEventData.ConversationId / CopilotEventData.ThreadId (CH) |
مفتاح الانضمام الأساسي للجري. بدونه، لا تظهر السلسلة في عروض نشاط وكلاء Defender أو مركز الإدارة. |
microsoft.channel.name |
All | M |
ChannelName (IA، شرق الولايات المتحدة) |
السطح الذي يركض عليه الوكيل. استخدم رمزا صغيرا قصيرا؛ القيم الكانونية المستخدمة في فلاتر Defender / مركز الإدارة اليوم هي msteams و outlook. يتم قبول سلاسل مخصصة (مثل web، <your-product-name>) لكنها لا تتحول إلى فلاتر القناة المدمجة. نفس القيمة في كل فترة فاصلة. انظر اختيار القيم. |
microsoft.channel.link |
All | O | -- | Channel deep-link. |
microsoft.session.id |
All | O | SessionIdentity |
تدور الجلسة فارغة إذا لم يلاحظ ذلك. |
microsoft.session.description |
All | O | -- | Session description. |
microsoft.conversation.item.link |
All | O | -- | رابط عميق للرسالة. |
correlation.id |
All | O | -- | Cross-service tracing. لم يظهر اليوم في الصيد المتقدم. |
operation.source |
All | O |
InvokeSource (IA) |
معرف لحزمة تطوير البرمجيات / الخدمة التي تصدر بيانات التليمترية. قد تكون سمة من سمة المورد. |
client.address |
IA، ET، CH | M |
ClientIP (IA، شرق الولايات المتحدة) |
Caller IP. التحقيق القائم على الملكية الفكرية محظور إذا كان فارغا. |
server.address |
IA، ET، CH | M |
ServerAddress (IA، شرق الولايات المتحدة) |
نقطة النهاية التي تتصل بها خدمتك. |
server.port |
IA، ET، CH | M |
ServerPort (IA) |
مشفرة بالنص (على سبيل المثال "443"). |
user.id |
IA | M | UserKey |
معرف كائن Microsoft Entra للمتصل البشري. "من أدار هذا العميل" فارغة بدونها. |
user.email |
IA | O | UserId |
UPN للمتصل. |
user.name |
IA | O | -- | اسم المستخدم. |
gen_ai.input.messages |
IA, CH | M | -- | حمولة طلب (سلسلة JSON). تم القبض عليه للتحليل في الأسفل لكنه لم يظهر بعد في الصيد المتقدم. |
gen_ai.output.messages |
IA، CH، OM | M | -- | حمولة الاستجابة (سلسلة JSON). |
gen_ai.execution.type |
IA | O | -- | واحد من HumanToAgent، Agent2Agent، . EventToAgent |
microsoft.a365.agent.thought.process |
IA, CH | O | -- | التفكير الحر / سلسلة الأفكار. |
gen_ai.author.app.id |
OM | O | -- | معرف تطبيق Microsoft Entra للتطبيق الذي قام بتأليف / إنشاء الوكيل. |
gen_ai.tool.name |
ET | M | ToolName |
Tool name. عروض استخدام أداة Defender فارغة إذا كانت مفقودة. |
gen_ai.tool.type |
ET | M | ToolType |
واحد من function، Power Platform Connector، MCP Server، API، Knowledge Sourcebing_grounding، code_interpreter، . file_search |
gen_ai.tool.call.id |
ET | M | ToolId |
معرف هذا الاسم لأداة الاتصال. |
gen_ai.tool.call.arguments |
ET | M | -- | وسائط الأدوات (سلسلة JSON). تم أسرها لكنها لم تظهر بعد في الصيد المتقدم. |
gen_ai.tool.call.result |
ET | M | -- | نتيجة الأداة (سلسلة JSON). |
gen_ai.tool.description |
ET | O | ToolDescription |
Tool description. |
gen_ai.tool.server.name |
ET | O | -- | اسم مضيف خادم الأدوات. قم بتعيين هذه السمة لأدوات MCP. |
gen_ai.request.model |
CH | M | -- | اسم النموذج (على سبيل المثال، gpt-4o). تم أسرها لكنها لم تظهر بعد في الصيد المتقدم. |
gen_ai.provider.name |
CH | M | -- | اسم المزود (على سبيل المثال، openai). |
gen_ai.usage.input_tokens |
CH | O | -- | عدد رموز الإدخال، مشفر بالسلاسل النصية. |
gen_ai.usage.output_tokens |
CH | O | -- | عدد رموز الإخراج، مشفر بالسلاسل النصية. |
gen_ai.response.finish_reasons |
CH | O | -- | Finish reason(s). |
microsoft.a365.caller.agent.id |
IA | M*² | -- | أتصل بوكيل الطلب. مطلوب للتعامل بين الوكيل. |
microsoft.a365.caller.agent.name |
IA | M*² | -- | اسم عرض وكيل الاتصال. |
microsoft.a365.caller.agent.blueprint.id |
IA | M*² | AgentBlueprintId |
تطبيق مخطط وكيل الاتصال. مطلوب لاستخدام A2A المجسد. |
microsoft.a365.caller.agent.user.id |
IA | M*² | -- | أتصل بمعرف المستخدم الخاص بوكيل. |
microsoft.a365.caller.agent.user.email |
IA | M*² | -- | أتصل بوكيل UPN. |
microsoft.a365.caller.agent.platform.id |
IA | N/A | -- | مخصص للمعرفات البديلة غير التابعة لإنترا (Entra). |
gen_ai.caller.agent.type |
IA | N/A | -- | العميل 365 يصنف تلقائيا. |
microsoft.agent.user.id |
IA، ET، CH | M*¹ |
TargetAgentUserKey (IA); UserKey (ET، CH) |
معرف الكائن Microsoft Entra لحساب المستخدم الخاص بالوكيل. مطلوب لزملاء الذكاء الاصطناعي / الوكلاء المتجسدين. |
microsoft.agent.user.email |
IA، ET، CH | O*¹ |
UserId (ET، CH) |
UPN لحساب مستخدم الوكيل. |
span.SpanId |
All | M | OpId |
OTel SDK يصدر هذا. |
span.ParentSpanId |
All | M*³ | ParentId |
مطلوب فقط للامتدادات غير الجذرية؛ الجذر invoke_agent لا يحتوي على أي منها. |
span.StartTimeUnixNano |
All | M | المستوى TimeGenerated الأعلى (أيضا CreationTime في RawEventData) |
نانو يونكس إيبوك كسلسلة. |
span.EndTimeUnixNano |
All | M |
CompletionTime (IA، شرق إنجلس)؛ CopilotEventData.CompletionTime (CH) |
لا يمكن حساب المدة إذا كانت مفقودة. |
span.Status.Message |
All | O*⁴ |
ErrorMessage (IA، شرق إنجلس)؛ CopilotEventData.ErrorMessage (CH) |
السبب الجذري للمحاولات الفاشلة فارغ إذا كان مفقودا. |
span.Status.Code |
All | O*⁴ |
ErrorType (IA); CopilotEventData.ErrorType (CH) |
فئة الخطأ فارغة إذا كان مفقودا. |
Note
عدة سمات تصدرها (مثل أدوات الوسائط / النتائج، معلمات النموذج، وروابط القنوات العميقة) مقبولة من قبل Agent 365 وتستخدم في عروض Microsoft Defender اللاحقة، لكنها لم تظهر بعد كمفتاح JSON CloudAppEvents.RawEventData. ضبطها حسب عمود المطلوب على أي حال - قد تضاف إلى حمولة الصيد في إصدار مستقبلي.
اختيار القيم عندما لا يكون لديك قيم طبيعية
بعض السمات المطلوبة تصف مفاهيم قد لا تكون موجودة في بنية وكيلك. إذا لم تكن القيمة الطبيعية موجودة، فإليك ما يجب ضبطه بدلا من ذلك. لا تترك حقلا إلزاميا فارغا—حتى واجهة المستخدم الصفرية بالكامل ستخفي تجربتك عن بعض التجارب الموجهة للعملاء.
| سؤال / سيناريو | Field(s) | ماذا نضبط |
|---|---|---|
| وكيلي هو <تسجيل تطبيق Entra القياسي> (ليس مبنيا على مخطط معرف عامل Entra). | gen_ai.agent.id |
تطبيق تطبيق إنترا. |
| ↑ نفس السيناريو | microsoft.a365.agent.blueprint.id |
أعد استخدام نفس القيمة مثل gen_ai.agent.id (معرف تطبيق الوكيل). يتطلب المخطط قيمة غير فارغة؛ إعادة استخدام تطبيق الوكيل هو الخيار الافتراضي الآمن عندما لا يوجد مخطط. |
| وكيلي هو مبني من مخطط معرف عامل Entra - واحد أو عدة هويات وكلاء تم سكها من نفس المخطط. | gen_ai.agent.id |
تطبيق هوية الوكيل ( appIdالمثيرة ، وليس المخطط). |
| ↑ نفس السيناريو | microsoft.a365.agent.blueprint.id |
المخطط تم تطبيقه. جميع الحالات التي تم سكها من نفس المخطط تشترك في هذه القيمة. |
| المتصل هو مستخدم بشري، وليس عميلا آخر. | الجميع microsoft.a365.caller.agent.* والسمات gen_ai.caller.agent.* |
Omit. هي إلزامية فقط في سيناريوهات الوكيل إلى الوكيل. |
| في الوكيل إلى الوكيل: الوكيل المستدعي هو تطبيق إنترا قياسي (بدون مخطط). | microsoft.a365.caller.agent.blueprint.id |
أعد استخدام تطبيق وكيل الاتصال. |
| وكيلي ليس زميلا في الذكاء الاصطناعي - ليس لديه حساب مستخدم خاص به في المستأجر. | جميع microsoft.agent.user.* السمات |
Omit. تكون إلزامية فقط عندما يكون لدى الوكيل حساب مستخدم خاص به على معرف عامل Entra. |
| وكيل أعمالي ليس لديه فكرة عن جلسة تتجاوز جولة واحدة. | microsoft.session.id |
اختياري - حذف. إذا كنت تريد أن تكون كل جولة جلسة مستقلة، قم بتعيين واجهة مستخدم لكل تشغيل. |
| وكيل أعمالي ليس لديه مفهوم للمحادثة (جلسة واحدة، بدون جنسية). | gen_ai.conversation.id |
قم بتوليد واجهة مستخدم رسومية جديدة في كل جولة. الملعب إلزامي؛ تخطيه يزيل السلسلة من عروض Defender وكيل النشاط ونظام مركز مسؤولي Microsoft 365. |
| المتصل لا يملك عنوان IP (على سبيل المثال، مشغل مجدول ذاتي). | client.address |
استخدم العنصر المؤقت المستقر الذي تتحكم به (على سبيل المثال، "0.0.0.0"). الملعب إلزامي؛ القيمة الفارغة تزيل السلسلة من محاور التحقيق المعتمدة على الملكية الفكرية. |
| يعمل الوكيل أثناء العملية؛ لا يوجد "خادم" منفصل يتم استدعاؤه. | server.address / server.port |
استخدم اسم المضيف للجهاز الذي شغل الوكيل (على سبيل المثال، myagent.example.com) والمنفذ الذي تستمع إليه نقطة النهاية الخاصة بك. مطلوب حتى عندما لا توجد خدمة منفصلة في المراحل النهائية. |
جهازي chat السريع لا يستخدم رموز نموذجية. |
gen_ai.usage.input_tokens / gen_ai.usage.output_tokens |
اختياري - حذف. إذا كان لديك أعداد تقريبية، أرسلها ك stringValue. |
| المسافة التي أبلغ عنها لا يوجد خطأ في البرنامج. |
span.Status.Message، span.Status.Code |
اضبط حالة OTel على OK (الرمز الرقمي 1) واحذف الرسالة. الأنبوب يستشاور هذه الحقول فقط عندما تكون الحالة هي Error. |
| وكيلي يستخدم نظام هوية غير تابع لإنترا (الوكيل ليس لديه تسجيل إنترا). |
microsoft.a365.agent.platform.id وgen_ai.agent.type |
ضبطوا كلاهما، على كل فتحة.
platform.id هو معرف الوكيل الفريد في نظام هويتك ؛ agent.type هو تسمية قصيرة تحدد أي نظام هوية هو ذلك. كلاهما نص حر - اختر ما يناسب نظامك.
لا تستخدم قيم الأنواع المحجوزة Microsoft: CustomBuiltAgentsUsingSDK، CopilotStudio، Foundry، DeclarativeAgent، Custom (هذه القيم مخصصة للأسطح الداخلية Microsoft). تطبيق الاتصال الذي تصادق عليه لا يزال يحتاج إلى تسجيل Entra لاستخدام هذه المسارات - زوج التعريف البديل يصف وكيل الهدف ، وليس المتصل. |
ما القيمة التي يجب أن أضعها microsoft.channel.name؟ |
microsoft.channel.name |
السطح الذي يركض عليه الوكيل. Defender وAdmin Center يقومون بتصفية المفاتيح من السلسلة الحرفية، لذا استخدم رمزا قصيرا وثابتا بحروف صغيرة. اليوم، القيم القانونية هي msteams و outlook؛ الأسطح الشائعة التي تواجه العملاء تستخدم webأيضا ، office، sharepoint، أو <your-product-name>. اختر قيمة واحدة والتزم بها - الأدوات لا تستطيع التوفيق بين msteams و Microsoft Teams كنفس القناة. |
هل يجب أن أضبط gen_ai.agent.type؟ |
gen_ai.agent.type |
فقط إذا كنت تضبط microsoft.a365.agent.platform.id نفسك أيضا (على سبيل المثال، وكيلك لا يملك تسجيل إنترا). يخبر الزوجان العميل 365 من أي نظام هوية جاء العميل. اختر تسمية قصيرة تحدد نظام هويتك بشكل فريد.
لا تستخدم CustomBuiltAgentsUsingSDK، CopilotStudio، Foundry، DeclarativeAgent، أو Custom - هذه القيم مخصصة للاستخدام الداخلي Microsoft. بالنسبة للوكلاء المسجلين في Entra، يرجى حذف الحقل؛ العميل 365 يملأ الباب. |
ما هو OTLP الذي يجب أن أضبطه على المقاطع الطويلة (OTLP) kind ؟ |
span.kind |
استخدم قيمة العدد الصحيح، وليس سلسلة العدد الأولي - 1 (INTERNAL)، 2 (SERVER)، 3 (CLIENT)، 4 ()، (PRODUCERCONSUMER). 5 الوكيل 365 يقبل أيا من هذه ولا يستمد سلوكا مرئيا للعميل من kind، لذا 1 (داخلي) هو خيار افتراضي آمن لكل فترة فاصلة. إذا كنت تريد أن يعكس شكل النداء، INTERNAL فإن ل / output_messagesinvoke_agentو CLIENT ل chat / execute_tool هو أمر معقول. |