Интеграция наблюдаемости для Copilot Studio

Агенты Microsoft Copilot Studio автоматически передают телеметрию на сервер наблюдаемости Microsoft Agent 365 — не требуется ручное оборудование SDK. Эта автоматическая наблюдаемость обеспечивает видимость активности, производительности и ошибок агентов в Центр администрирования Microsoft 365, Microsoft Defender и Microsoft Purview.

В этой статье объясняется, как Copilot Studio автоматически обрабатывает наблюдаемость и где можно просматривать телеметрические данные.

Замечание

Общие концепции наблюдаемости Агента 365 и ручное оборудование для про-кодовых агентов см. раздел Агент наблюдаемости. В этой статье рассматривается автоматическая наблюдаемость для агентов Copilot Studio.

Автоматическая наблюдаемость

Агенты Copilot Studio автоматически участвуют в фреймворке наблюдаемости Agent 365:

  • SDK не требуется: в отличие от про-кодовых агентов, требующих установки и настройки SDK OpenTelemetry, Copilot Studio обрабатывает всю телеметрию в среде выполнения платформы.
  • Соответствие OpenTelemetry: Телеметрия следует семантическим конвенциям OpenTelemetry, обеспечивая согласованность с про-кодовыми агентами и другими платформами.
  • Автоматическое поглощение: телеметрия поступает на сервер наблюдаемости Agent 365 без дополнительной настройки.
  • Немедленная доступность: данные наблюдаемости появляются в Центр администрирования Microsoft 365 в течение нескольких минут после активности агента.

Эта автоматизация обеспечивает централизованный мониторинг, анализ безопасности и отчётность по соответствию без усилий разработчиков.

Какая телеметрия фиксируется

Copilot Studio автоматически излучает две семантические конвенции OpenTelemetry для генеративных AI-диапазонов:

Замечание

  • Телеметрия фиксируется только для аутентифицированных сессий
  • Агенты с мультиарендаторами исключены из телеметрии
  • Агенты с именами длиннее 42 символов не регистрируются
  • Большие входы и выходы автоматически усечаны в следующих полях:
    • Выводные сообщения
    • Аргументы инструментов
    • Отклик инструмента (gen_ai.event.content)
    • Описание агента

Агент вызова

Захватывает активность призыва агента:

  • Идентификация агента: ID, имя, Entra ID и тип вызванного агента
  • Идентификация пользователя: кто взаимодействовал с агентом (при использовании от имени потока)
  • Вводное сообщение: пользовательское сообщение, отправленное агенту (чувствительные данные скрыты)
  • Другие идентификаторы: идентификаторы арендаторов и окружения
  • Временные метки начала и конца: когда началось и закончилось призыв

Пример события

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

Инструмент выполнения

Захватывает выполнение инструмента, когда ваш агент использует соединители или действия:

  • Идентификация агента: ID, имя, Entra ID и тип вызванного агента
  • Идентификация инструмента: ID и имя исполняемого инструмента
  • Аргументы инструмента: Какие данные были отправлены (чувствительные данные скрыты)
  • Идентификация пользователя: кто взаимодействовал с агентом (при использовании On-Behalf-Of flow)
  • Другие идентификаторы: идентификаторы арендаторов и окружения
  • Временные метки начала и конца: Когда началось и закончилось выполнение

Ниже приведён ещё один пример события.

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

Вся телеметрия уважает границы конфиденциальности. Конфиденциальные пользовательские данные в сообщениях и входах и выводах инструментов скрыты и не видны администраторам. Телеметрия используется для мониторинга внутренней безопасности и целей соблюдения требований.

Дальнейшие шаги

  • Last updated on