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

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

Обновлено вчера

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

Analytics API доступен на Enterprise планах. Владельцы Primary Organizations могут генерировать ключи 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, такие как коммиты, pull requests и строки кода.

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

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

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

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


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

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

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

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

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