Copilot Studio için gözlemlenebilirlik entegrasyonu

Microsoft Copilot Studio aracıları otomatik olarak Microsoft Agent 365 gözlemlenebilirlik arka uçuna telemetri yayımlar—manuel SDK enstrumantasyonu gerekmez. Bu otomatik gözlemlenebilirlik, Microsoft 365 yönetim merkezi, Microsoft Defender ve Microsoft Purview genelinde aracı etkinliği, performansı ve hatalarına görünürlük sağlar.

Bu makale, Copilot Studio'nun gözlemlenebilirliği nasıl otomatik olarak sağladığını ve telemetri verilerinin nerede görüntülenebileceğini açıklar.

Not

Genel Agent 365 gözlemlenebilirlik kavramları ve pro-kod aracıları için manuel enstrümantasyon hakkında ayrıntılar için Aracı gözlemlenebilirliği sayfasını inceleyin. Bu makale, Copilot Studio aracıları için otomatik gözlemlenebilirliğe odaklanmaktadır.

Otomatik gözlemlilik

Copilot Studio aracıları Agent 365 gözlemlenebilirlik çerçevesine otomatik olarak dahil olur:

  • SDK gerekmez: OpenTelemetry SDK kurulumu ve yapılandırması gerektiren pro-code aracıların aksine, Copilot Studio tüm telemetri verilerinin yayımını platform çalışma zamanında otomatik olarak gerçekleştirir.
  • OpenTelemetry uyumluluğu: Telemetri, OpenTelemetry anlamsal sözleşmelerini takip eder ve pro-kod aracıları ile diğer platformlarla tutarlılığı sağlar.
  • Otomatik aktarım: Telemetri, ek bir yapılandırmaya gerek olmadan Agent 365 gözlemlenebilirlik arka uç sistemine aktarılır.
  • Anında erişilebilirlik: Gözlemlenebilirlik verileri, aracı etkinliğinden birkaç dakika sonra Microsoft 365 yönetim merkezinde görünür.

Bu otomasyon, geliştirici müdahalesine gerek olmadan merkezi izleme, güvenlik analizi ve uyumluluk raporlamasını sağlar.

Hangi telemetri toplanır

Copilot Studio, üretici AI span’leri için iki OpenTelemetry anlamsal sözleşmesi otomatik olarak gönderir:

Not

  • Telemetri yalnızca doğrulanmış oturumlar için kaydedilir
  • Çok kiracılı aracılar telemetriden hariç tutulur
  • 42 karakterden uzun isimli aracılar kayıt yapılmıyor
  • Büyük girdiler ve çıktılar aşağıdaki alanlarda otomatik olarak kısaltılır:
    • Çıktı mesajları
    • Araç parametreleri
    • Araç yanıtı (gen_ai.event.content)
    • Aracı açıklaması

Aracıyı çağır

Aracı çağrı etkinliğini yakalar:

  • Aracı tanımlama: Çağrılan aracının kimliği, adı, Entra ID'si ve türü
  • Kullanıcı kimliği: Aracıla kimin etkileşimde bulunduğu (on-behalf-of akışı kullanılırken)
  • Giriş mesajı: Aracıya gönderilen kullanıcı mesajı (hassas veri çıkarılmıştır)
  • Diğer tanımlayıcılar: Kiracı ve ortam kimlikleri
  • Başlangıç ve bitiş zaman damgaları: Çağrının başladığı ve bittiği zaman

Örnek etkinlik

{
  "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"
}

Çıktı mesajı

Aracının çıktısı kaydedilir:

  • Çıktı mesajı: Aracının kullanıcıya verdiği yanıt (hassas veri çıkarılmış)

Not

Aracı çağrılarından veya araç çalıştırmalarından gelen hata mesajları çıktı mesajları olarak kaydedilir.

Aşağıda başka bir örnek olay yer almaktadır.

{
  "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"
}

Aracı çalıştır

Aracınız bağlayıcılar veya eylemler kullandığında araç çalıştırma olayını kaydeder:

  • Aracı tanımlama: Çağrılan aracının kimliği, adı, Entra ID'si ve türü
  • Araç kimliği: Çalıştırılan aracın kimliği ve adı
  • Araç argümanları: Hangi veriler gönderildi (hassas veri çıkarıldı)
  • Kullanıcı kimliği: Aracıla etkileşim kuran kişi (On-Behalf-Of akışı kullanılırken)
  • Diğer tanımlayıcılar: Kiracı ve ortam kimlikleri
  • Başlangıç ve bitiş zaman damgaları: İşlemin başladığı ve sona erdiği zaman

Aşağıda başka bir örnek olay yer almaktadır.

{
  "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"
}

Tüm telemetri gizlilik sınırlarına saygı gösterir. Mesajlar ve araç girişleri ile çıktılarındaki hassas kullanıcı verileri maskelenir ve yöneticiler tarafından görünür değildir. Telemetri, iç güvenlik izleme ve uyum amaçları için kullanılır.

Sonraki adımlar

  • Last updated on