К основному содержимому

Получайте данные об engagement и adoption через Analytics API

Обновлено более месяца назад

Analytics API предоставляет владельцам Primary Organizations на плане Enterprise программный доступ к данным об использовании и внедрении для своей организации. Используйте его для создания внутренних панелей управления, отслеживания тенденций внедрения и передачи данных об использовании Claude в ваши существующие инструменты отчетности.

Analytics API доступен на планах Enterprise. Владельцы Primary могут генерировать ключи API для начала работы.

Чем это отличается от панели аналитики и Compliance API?

Все три варианта предоставляют различные представления данных вашей организации:

Панель аналитики (доступна через Analytics) показывает визуализированные данные об использовании в продукте. Это правильный инструмент для ежедневного мониторинга, когда вам не нужно интегрировать данные в другие места.

Analytics API возвращает те же агрегированные метрики использования и вовлеченности, но программным способом — так что вы можете загружать их в инструменты BI, сопоставлять с организационными структурами или автоматизировать рабочие процессы отчетности. Данные агрегируются по организации, в день.

Compliance API предназначен для случаев использования управления и аудита. Он дает вам доступ к отдельным действиям пользователей, необработанным событиям активности и содержимому беседы. Если вам нужны агрегированные метрики вовлеченности для панелей управления, а не необработанные события для аудита, используйте Analytics API.


Начало работы

Для доступа к Analytics API вам нужен доступ Primary Owner к вашей организации Enterprise.

Выполните следующие шаги:

  1. Перейдите в Analytics > API keys.

  2. Найдите переключатель Access под Analytics API и включите его.

  3. Нажмите "+ Create key" для создания нового ключа API. Держите этот ключ в секрете — относитесь к нему как к пароль.

  4. Используйте ключ с заголовком x-api-key в ваших запросах.

Для получения полной информации об аутентификации, справочной информации по конечным точкам и примеров кода обратитесь к нашему Claude Enterprise Analytics API reference guide.


Какие данные доступны?

Analytics API включает пять конечных точек. Все данные агрегируются по организации, в день, и доступны за последние 90 дней (не ранее 1 января 2026 г.).

  • Активность пользователя: Метрики вовлеченности для каждого пользователя, включая количество беседы, отправленные сообщения, созданные проекты, загруженные файлы, созданные артефакты, использованные навыки, использованные соединители и метрики Claude Code, такие как коммиты, запросы на слияние и строки кода.

  • Сводка активности: Ежедневное, еженедельное и ежемесячное количество активных пользователей на уровне организации, а также использование мест и количество ожидающих приглашений. Поддерживает диапазоны дат до 31 дня за запрос.

  • Использование проектов чата: Количество беседы и пользователей, разбитое по проектам для Claude проектов.

  • Использование навыков: Сколько пользователей используют каждый навык, с разбивкой для Claude и Claude Code сеансов отдельно.

  • Использование соединителей: Какие соединители использует ваша организация и сколько уникальных пользователей использовали каждый из них.


Ограничения данных

Все конечные точки возвращают данные за одну дату или диапазон дат. Данные доступны только после 1 января 2026 г. и для дат более чем три дня назад.

API имеет ограничение частоты по умолчанию 60 запросов в минуту. Если это не соответствует потребностям вашей организации, обратитесь к вашему контакту Anthropic или нашей команде продаж.

Важно: Если вы используете Claude Code через Amazon Bedrock, Analytics API не будет возвращать данные, связанные с Claude Code.

Нашли ответ на свой вопрос?