Получение стенограмм сеансов
Получайте список сеансов, которые ваши пользователи запускают в приложениях и агентах Claude, таких как Claude Cowork и Claude Code, и извлекайте их стенограммы через Compliance API.
Конечные точки на этой странице предоставляют стенограммы сеансов из ваших организаций Claude Enterprise специалистам по проверке соответствия требованиям. Стенограммы охватывают сеансы, которые ваши пользователи запускают в приложениях и агентах Claude (Cowork, Claude Code, Claude Science, Claude for Microsoft 365, надстройки Claude для Google Docs, Google Sheets и Google Slides, Claude in Chrome и Claude Tag). Каждый сеанс — это одна беседа с Claude; его стенограмма — это последовательность пользовательских подсказок, ответов ассистента, а также вызовов инструментов и их результатов в этой беседе. Конечные точки поддерживают экспорт для eDiscovery («electronic discovery», электронное раскрытие информации) и применение политик «data loss prevention» (предотвращение утечки данных), или DLP.
Compliance API группирует сеансы в два семейства конечных точек в зависимости от того, где они выполняются: конечные точки локальных сеансов — для сеансов на компьютерах пользователей, и конечные точки удалённых сеансов — для сеансов, которые выполняются в облаке в средах, управляемых Anthropic, или, в случае Claude Tag, в самостоятельно размещённом пуле раннеров. Оба семейства доступны только для чтения, и ни одно из них не доступно для ключей Admin API (sk-ant-admin01-...): вызовы, аутентифицированные с помощью ключа Admin API, возвращают 403 Forbidden.
В следующей таблице для каждого продукта и места его выполнения указано семейство конечных точек, которое возвращает его сеансы, и значение product_surface, которое идентифицирует их в ответах.
| Продукт и место выполнения | Семейство конечных точек | product_surface |
|---|---|---|
| Cowork в Claude Desktop, выполняется на компьютере пользователя | Конечные точки локальных сеансов (/v1/compliance/apps/sessions/local) | cowork |
| Claude Code в терминале, в Claude Desktop или в расширении IDE, выполняется на компьютере пользователя | Конечные точки локальных сеансов | claude_code |
| Настольное приложение Claude Science, выполняется на компьютере пользователя | Конечные точки локальных сеансов | claude_science |
| Claude for Microsoft 365 (надстройки Claude для Excel, PowerPoint, Word и Outlook), выполняется в настольных или веб-приложениях Microsoft 365 | Конечные точки локальных сеансов | office_agents/excel, office_agents/powerpoint, office_agents/word или office_agents/outlook |
| Надстройки Claude для Google Docs, Google Sheets и Google Slides, выполняются в этих приложениях Google | Конечные точки локальных сеансов | office_agents/google_docs, office_agents/google_sheets или office_agents/google_slides |
| Claude in Chrome (встроенный чат расширения браузера), выполняется на компьютере пользователя | Конечные точки локальных сеансов | claude_in_chrome |
| Сеансы Cowork, выполняющиеся в облаке в средах, управляемых Anthropic, включая сеансы, запущенные в веб-версии или мобильном приложении claude.ai, и облачные запуски запланированных задач Cowork | Конечные точки удалённых сеансов (/v1/compliance/apps/sessions/remote) | cowork_remote |
| Сеансы Claude Tag, запущенные в Slack, выполняются в облаке в средах, управляемых Anthropic, или в самостоятельно размещённом пуле раннеров | Конечные точки удалённых сеансов | claude_tag |
Значение office_agents само по себе не указывает, из какого приложения пришёл сеанс, и он может быть как из Claude for Microsoft 365, так и из надстроек Google. См. описание product_surface в разделе Сеансы на компьютерах пользователей.
Сбор локальных сеансов привязан к тому, что Compliance API включён для вашей организации, и применяется, пока пользователи выполнили вход со своей учётной записью Claude Enterprise. Конечные точки сеансов не возвращают следующее:
- Сеансы Claude Code, аутентифицированные с помощью ключа API Claude Console или запущенные через стороннюю облачную платформу, такую как Amazon Bedrock, Google Cloud или Microsoft Foundry.
- Облачные сеансы Claude Code (включая облачные запланированные задачи Claude Code), которые выполняются в облачной инфраструктуре, а не на компьютере пользователя. Эти облачные сеансы не являются удалёнными сеансами, хотя и те и другие выполняются в облаке; конечные точки удалённых сеансов возвращают только сеансы Cowork и Claude Tag.
- Локальные сеансы продуктов, отличных от Cowork и Claude Code, в организациях с включённой готовностью к HIPAA. В таких организациях конечные точки локальных сеансов возвращают только сеансы Cowork и Claude Code, а собранное содержимое сеансов хранится 30 дней.
- Локальные сеансы, для которых действует «zero data retention» (нулевое хранение данных), или ZDR. Эти сеансы исключаются из результатов списка, а конечные точки получения сеанса и сообщений возвращают для них 404.
Anthropic рекомендует использовать Compliance API для получения содержимого сеансов. В следующей таблице локальные сеансы и удалённые сеансы сравниваются с альтернативами на основе OpenTelemetry, доступными для Cowork и Claude Code: журналированием OpenTelemetry в Cowork и мониторингом Claude Code.
| Локальные сеансы (на компьютерах пользователей) | Удалённые сеансы (в облаке) | Журналирование OpenTelemetry | |
|---|---|---|---|
| Доставка | Pull: запрос и экспорт по HTTPS | Pull: запрос и экспорт по HTTPS | Push: потоковая передача в ваш коллектор OTLP |
| Настройка | Работает с вашим существующим Compliance Access Key | Работает с вашим существующим Compliance Access Key | Администратор настраивает конечную точку OTLP и параметры сбора содержимого |
| Инфраструктура | Размещается Anthropic | Размещается Anthropic | Вы управляете коллектором и хранилищем |
| Префикс ID | clls_ | cse_ | Н/Д |
Значения product_surface | cowork, claude_code, claude_science, claude_in_chrome и значения, начинающиеся с office_agents | cowork_remote, claude_tag | Н/Д |
| Хранение | По умолчанию 6 лет или пользовательский период хранения разговоров вашей организации, если задан конечный период; 30 дней в организациях с включённой готовностью к HIPAA; хранится Anthropic | Нет периода по умолчанию; см. Хранение и удаление; хранится Anthropic | Ваша инфраструктура, ваши политики |
| Пользовательские подсказки и ответы ассистента | Да | Да | Да, в зависимости от параметров сбора содержимого |
| Входные данные инструментов | По умолчанию усекаются до 10 000 байт на каждый вход; по запросу — примерно до 1 МиБ | По умолчанию усекаются до 10 000 байт на каждый вход; по запросу — примерно до 1 МиБ | Усечённые сводки |
| Содержимое результатов инструментов | Каждая текстовая запись по умолчанию усекается до 10 000 байт; по запросу — примерно до 1 МиБ | Каждая текстовая запись по умолчанию усекается до 10 000 байт; по запросу — примерно до 1 МиБ | Метаданные, такие как размер и успешность; Claude Code также может собирать содержимое с помощью необязательной настройки с ограничением размера |
| Содержимое файлов | Да, через вызовы инструментов в стенограмме (только текст; прочее содержимое отображается как заполнитель) | Да, через вызовы инструментов в стенограмме (только текст; прочее содержимое опускается) | Пути к файлам; Claude Code также может собирать содержимое с помощью необязательной настройки с ограничением размера |
| Метаданные хоста и устройства (тип терминала, пути рабочей области) | Нет | Нет | Да |
| Использование токенов и стоимость | Нет; доступно через Claude Enterprise Analytics API | Нет; доступно через Claude Enterprise Analytics API | Да |
Сеансы на компьютерах пользователей (локальные сеансы)
Локальные сеансы выполняются на компьютерах пользователей, пока пользователи находятся в системе под своей учётной записью Claude Enterprise, — в следующих продуктах:
- Cowork в Claude Desktop
- Claude Code (в терминале, в Claude Desktop или в расширении IDE)
- Настольное приложение Claude Science
- Claude for Microsoft 365 (в Excel, PowerPoint, Word и Outlook)
- Надстройки Claude для Google Docs, Google Sheets и Google Slides
- Расширение браузера Claude in Chrome
Compliance API предоставляет локальные сеансы через три конечные точки: GET /v1/compliance/apps/sessions/local возвращает список метаданных сеансов, GET /v1/compliance/apps/sessions/local/{session_id} получает метаданные одного сеанса, а GET /v1/compliance/apps/sessions/local/{session_id}/messages возвращает стенограмму одного сеанса. Все три требуют области read:compliance_user_data и учитываются только в общем «rate limit» (ограничении скорости) Compliance API; на них не распространяется второй бюджет запросов, который применяется к конечным точкам удалённых сеансов. См. 429 Too Many Requests. Если локальные сеансы недоступны для вашей родительской организации, все три конечные точки возвращают 404 с сообщением Local sessions are not available. (см. Локальная сессия не найдена); пока списки сеансов или собранное содержимое временно недоступны, они возвращают 503 (см. Локальные сеансы временно недоступны).
Для локальных сеансов Anthropic записывает каждую беседу на стороне сервера по мере того, как её запросы поступают в Claude API; на устройство ничего не устанавливается, и ничего не собирается сверх запросов, которые клиент и так отправляет в Claude API. Стенограммы локальных сеансов показывают, что Claude попросили сделать и что он вернул, а не то, что происходило на устройстве. Файловая и сетевая активность видна только через вызовы инструментов и результаты инструментов в стенограмме, поэтому активность, которая никогда не достигает API (например, локальные файлы, которые сеанс никогда не отправлял), не захватывается.
В организациях, использующих ключи шифрования, управляемые клиентом, стенограммы локальных сеансов шифруются вашим ключом, управляемым клиентом, и возвращаются как обычно. Пока этот ключ невозможно использовать (например, потому что вы отключили или отозвали его, или потому что он недоступен), конечная точка сообщений возвращает 503 Service Unavailable для затронутых страниц вместо содержимого стенограммы. Такие сообщения никогда не помечаются как not_captured (см. Получение стенограммы локального сеанса). Получение списка сеансов и метаданных сеансов это не затрагивает.
Конечная точка списка возвращает метаданные сеансов без содержимого стенограмм для каждой связанной организации, которую может читать ваш ключ. В отличие от списка удалённых сеансов, у неё нет фильтров по организации или пользователю: ограничивайте результаты по времени с помощью параметров created_at.gte, created_at.gt, created_at.lt и created_at.lte. Каждый из них принимает метку времени RFC 3339 с обязательным смещением UTC. Если вы указываете и нижнюю, и верхнюю границу, верхняя граница должна быть позже нижней (или равна ей, если вы используете created_at.gte вместе с created_at.lte), иначе запрос возвращает 400 Bad Request. Отдельный фильтр по времени, updated_at.gte, ограничивает по последней активности, а не по первой: он возвращает сеансы, последний вызов инференса которых произошёл в указанное время или позже, и сочетается с фильтрами created_at, не меняя порядок сортировки и пагинацию. Используйте его для опроса сеансов, активных с момента предыдущего прохода, как описано далее в этом разделе. Новые сеансы и сообщения появляются в результатах после небольшой задержки обработки, обычно в течение нескольких минут; сеанс, отсутствующий сразу после запуска, не обязательно не был собран. Следующий запрос возвращает список сеансов, созданных начиная с указанной даты.
curl --fail-with-body -sS -G \
"https://api.anthropic.com/v1/compliance/apps/sessions/local" \
-H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
-H "anthropic-version: 2026-10-21" \
--data-urlencode "created_at.gte=2026-07-01T00:00:00Z" \
--data-urlencode "limit=100"{
"data": [
{
"type": "compliance_local_session",
"id": "clls_01HxKpLmNoPqRsTuVwXyZaBc",
"organization_uuid": "9a1e0000-0000-0000-0000-000000000000",
"workspace_id": "wrkspc_01SvYKoWVRVHoEbwESNvzYdR",
"user": {
"id": "user_01GpKpLmNoPqRsTuVwXyZaBc",
"email_address": "engineer@example.com"
},
"product_surface": "cowork",
"created_at": "2026-07-09T14:02:11Z",
"updated_at": "2026-07-09T14:02:38Z"
},
{
"type": "compliance_local_session",
"id": "clls_01HyLqMnOpQrStUvWxYzAbCd",
"organization_uuid": "9a1e0000-0000-0000-0000-000000000000",
"workspace_id": null,
"user": {
"id": "user_01HqRsTuVwXyZaBcDeFgHiJk",
"email_address": null
},
"product_surface": "claude_code",
"created_at": "2026-07-08T09:15:43Z",
"updated_at": "2026-07-08T09:52:10Z"
}
],
"next_page": "page_AAEfQx7mPdLkq9Rt2VwHbZk"
}Результаты сортируются в обратном хронологическом порядке (сначала новые) по created_at, при равенстве — в фиксированном порядке на стороне сервера, и ограничиваются limit результатами на каждый ответ (по умолчанию 100, максимум 500). Конечная точка поддерживает пагинацию только вперёд с помощью токенов page и next_page (см. Постраничная навигация по результатам): передайте значение next_page из ответа в качестве параметра запроса page в следующем запросе и остановитесь, когда next_page равно null. В ответе нет поля has_more. Завершайте обход списка в течение 24 часов с момента его начала; более старый курсор списка по-прежнему принимается, но переоценивается относительно текущей границы хранения, поэтому сеансы, самая старая сохранённая активность которых вот-вот выйдет за пределы срока хранения, могут быть пропущены.
В каждом объекте сеанса user.id всегда задан и сохраняется после удаления учётной записи; user.email_address равен null, если учётная запись пользователя удалена или пользователь больше не является участником организации, которую может читать ваш ключ. workspace_id равен null, если сеанс не был связан с рабочим пространством. Локальный сеанс соответствует одному идентификатору клиентского сеанса: открытие новой беседы в клиенте или очистка её контекста создаёт новую запись сеанса. Для Claude Science список также может включать отдельные сеансы для собственной фоновой работы приложения (например, присвоения названия беседе; в более новых версиях приложения — также его треков проверки и делегирования), а в более старых версиях приложения часть этой фоновой работы отображается как дополнительные сообщения внутри стенограммы самой беседы. Беседа в Claude Science, продолжающаяся после некоторых обновлений приложения, отображается как два сеанса. Такое поведение ожидаемо. Рассматривайте значения id как непрозрачные строки; их формат может измениться без предупреждения.
Для Claude for Microsoft 365 и надстроек Claude для Google Docs, Google Sheets и Google Slides удаление беседы в надстройке происходит только на клиенте, поэтому оно не отражается в API: у локальных сеансов нет поля deleted_at, и сеанс остаётся в списке, пока его не удалит политика хранения.
Локальные сеансы имеют updated_at, но не имеют status: у локального сеанса нет статуса жизненного цикла на стороне сервера, и его видимость определяется сроком хранения. Локальный сеанс собирается как серия вызовов Claude API (вызовов инференса), которые клиент выполняет во время сеанса, и хранение применяется к каждому собранному вызову по отдельности. created_at — это метка времени самого раннего сохранённого вызова сеанса, а updated_at — метка времени последнего, обе в UTC. По мере того как более старые вызовы выходят за пределы периода хранения, created_at соответственно сдвигается вперёд, а когда все вызовы в сеансе выходят за пределы хранения, сеанс больше не возвращается; updated_at отслеживает самый последний вызов и до этого момента не меняется. Поскольку created_at может смещаться между запусками, выполняйте дедупликацию по id при повторном обходе списка с течением времени. Чтобы поддерживать стенограммы в актуальном состоянии по мере появления в сеансах новых сообщений, выполняйте опрос с фильтром updated_at.gte, перекрывая последовательные окна. В конечной точке списка updated_at является нижней границей: для сеанса, который всё ещё активен на границе страницы или на верхней границе окна created_at, он может на мгновение отставать от истинной последней активности сеанса, а новый вызов становится доступным для запросов только после упомянутой ранее небольшой задержки обработки. Из-за этого отставания устанавливайте updated_at.gte каждого запуска на несколько минут раньше времени начала предыдущего запуска, а не точно на время предыдущего запуска. Граница, установленная точно на предыдущее время, незаметно и безвозвратно теряет сеанс, последний вызов которого в тот момент ещё индексировался, потому что как только граница сдвигается за этот вызов, ни один последующий запуск его не вернёт. Выполняйте дедупликацию возвращённых сеансов по id, повторно получайте их стенограммы и выполняйте дедупликацию сообщений по id. Получение сеанса или его сообщений всегда отражает точный последний сохранённый вызов, поэтому периодический проход сверки по более старому окну — более тщательная альтернатива расширению перекрытия.
Список включает только сеансы, у которых есть хотя бы один захваченный вызов. Сеанс, завершившийся до начала захвата для вашей организации, в список не входит. Для сеанса, который в этот момент уже выполнялся, created_at — это время его первого захваченного вызова. Некоторые сообщения в сеансе из списка всё же могут быть помечены как недоступные, например потому, что политики обработки данных Anthropic не передают их содержимое (см. Получение стенограммы локального сеанса).
Собранное содержимое локальных сеансов по умолчанию хранится 6 лет с момента сбора. Если организация, в которой выполнялся сеанс, задала конечный пользовательский период хранения разговоров в claude.ai > Настройки организации > Данные и конфиденциальность, вместо этого применяется этот период, независимо от того, короче он или длиннее значения по умолчанию. Применяется только период, заданный для чатов или для всех данных; периоды, заданные для проектов или Artifacts, не влияют на локальные сеансы. Изменение этого периода вступает в силу двумя разными способами: конечные точки перестают возвращать активность старше текущего периода организации сразу после изменения настройки, тогда как каждое собранное сообщение хранится в течение периода, действовавшего на момент его сбора, поэтому последующее увеличение периода не восстанавливает уже истёкшее содержимое. В организациях с включённой готовностью к HIPAA собранное содержимое локальных сеансов хранится 30 дней с момента сбора или в течение пользовательского периода хранения разговоров организации, если он короче; значение по умолчанию в 6 лет не применяется.
Чтобы получить метаданные одного сеанса напрямую, передайте его ID в GET /v1/compliance/apps/sessions/local/{session_id}. Ответ — это тот же объект сеанса, который возвращает конечная точка списка, без оболочки и без содержимого стенограммы. Неправильно сформированный ID сеанса возвращает 400 Bad Request. Единый ответ 404 Not Found охватывает четыре случая, которые ответ не различает:
- Сеанс находится не в организации, которую может читать ваш ключ (включая сеансы в другой родительской организации).
- Сеанс не существует.
- Для сеанса действует нулевое хранение данных.
- Все вызовы в сеансе вышли за пределы срока хранения.
product_surface (строка или null) сообщает, из какого продукта пришёл сеанс. Значение равно null, если продукт не был записан. В противном случае это одно из следующих значений:
cowork: Cowork в Claude Desktop на компьютере пользователяclaude_code: Claude Codeclaude_science: Claude Scienceclaude_in_chrome: встроенный чат в расширении браузера Claude in Chromeoffice_agents/excel,office_agents/powerpoint,office_agents/wordилиoffice_agents/outlook: Claude for Microsoft 365 в Excel, PowerPoint, Word или Outlookoffice_agents/google_docs,office_agents/google_sheetsилиoffice_agents/google_slides: надстройка Claude для Google Docs, Google Sheets или Google Slidesoffice_agents: Claude for Microsoft 365 или одна из надстроек Google, если приложение не было записано
Если у сеанса указано только office_agents, ничто другое в ответе не сообщает, из какого из этих продуктов он пришёл. Не предполагайте, что это Claude for Microsoft 365.
Значение берётся из самой последней активности сеанса, поэтому оно может меняться со временем. API начал записывать значения для Google 5 октября 2026 года. Сеанс надстройки Google, самая последняя активность которого произошла в эту дату или раньше, может отображать office_agents. Если пользователь снова работает в этом сеансе, значение меняется на соответствующее значение для Google.
Получение стенограммы локального сеанса
Конечная точка сообщений возвращает стенограмму сеанса, восстановленную из собранных вызовов Claude API: пользовательские подсказки, текст ассистента, вызовы инструментов и текстовые части результатов инструментов — всё возвращается в том виде, в котором было отправлено, за исключением усечения по размеру. Ничто не маскирует URL-адреса, учётные данные или персональные данные в этом содержимом, поэтому обращайтесь со стенограммами как с конфиденциальными данными. Стенограмма опускает или заменяет следующее:
- Блоки размышлений никогда не включаются.
- Системная подсказка запроса никогда не возвращается. Вместо неё используется сообщение-маркер с текстом
[system prompt content not shown](обычно один раз на каждый сеанс; сеанс без доступного содержимого не содержит маркера). - Определения инструментов и конфигурация серверов MCP не входят в стенограмму.
- Изображения, PDF и другие двоичные или структурированные блоки не возвращаются. Каждый из них отображается как блок
textс текстом[<block type> content not shown](например,[image content not shown]) и значениемtruncated, равнымtrue. Нетекстовые элементы внутри результата инструмента, такие как результаты веб-поиска или вывод инструмента выполнения кода, заменяются одной записью[N non-text item(s) not shown], аtruncatedблока результата инструмента равенtrue. Соответствующий вызов инструмента с поисковым запросом или кодом в егоinputпо-прежнему возвращается. - Метаданные цитирования в блоках
text, такие как ссылки на источники в ответе, основанном на результатах веб-поиска, опускаются. Сам текст возвращается, а блок содержитtruncatedсо значениемtrue.
Файлы инструкций проекта, такие как CLAUDE.md, отображаются как обычное содержимое с ролью пользователя. Содержимое навыков отображается, когда клиент отправляет его как содержимое сообщения, и не отличается от другого пользовательского текста. Сводку по охвату см. в FAQ по Compliance API; таблицу сравнения локальных сеансов с удалёнными сеансами и журналированием OpenTelemetry см. во введении к этой странице.
curl --fail-with-body -sS \
"https://api.anthropic.com/v1/compliance/apps/sessions/local/clls_01HxKpLmNoPqRsTuVwXyZaBc/messages" \
-H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
-H "anthropic-version: 2026-10-21"{
"session": {
"type": "compliance_local_session",
"id": "clls_01HxKpLmNoPqRsTuVwXyZaBc",
"organization_uuid": "9a1e0000-0000-0000-0000-000000000000",
"workspace_id": "wrkspc_01SvYKoWVRVHoEbwESNvzYdR",
"user": {
"id": "user_01GpKpLmNoPqRsTuVwXyZaBc",
"email_address": null
},
"product_surface": "cowork",
"created_at": "2026-07-09T14:02:11Z",
"updated_at": "2026-07-09T14:02:38Z"
},
"data": [
{
"type": "compliance_local_session_message",
"id": "clsm_01J4KpLmNoPqRsTuVwXyZaBa",
"role": "user",
"model": null,
"created_at": "2026-07-09T14:02:11Z",
"provenance": {
"type": "synthetic_marker"
},
"content": [
{
"type": "text",
"text": "[system prompt content not shown]",
"truncated": true
}
]
},
{
"type": "compliance_local_session_message",
"id": "clsm_01J4KpLmNoPqRsTuVwXyZaBc",
"role": "user",
"model": null,
"created_at": "2026-07-09T14:02:11Z",
"provenance": null,
"content": [
{
"type": "text",
"text": "Fix the failing test in tests/auth_test.py",
"truncated": false
}
]
},
{
"type": "compliance_local_session_message",
"id": "clsm_01J4KpLmNoPqRsTuVwXyZaBd",
"role": "assistant",
"model": "claude-opus-5-5",
"created_at": "2026-07-09T14:02:11Z",
"provenance": null,
"content": [
{
"type": "text",
"text": "I'll read the test file first.",
"truncated": false
},
{
"type": "tool_use",
"id": "toolu_01AbCdEfGhIjKlMnOpQrSt",
"name": "Read",
"input": "{\"file_path\":\"tests/auth_test.py\"}",
"truncated": false
}
]
},
{
"type": "compliance_local_session_message",
"id": "clsm_01J4KpLmNoPqRsTuVwXyZaBe",
"role": "user",
"model": null,
"created_at": "2026-07-09T14:02:38Z",
"provenance": null,
"content": [
{
"type": "tool_result",
"tool_use_id": "toolu_01AbCdEfGhIjKlMnOpQrSt",
"name": "Read",
"is_error": false,
"content": [
{
"type": "text",
"text": "def test_login_expiry():\n ..."
}
],
"truncated": false
}
]
},
{
"type": "compliance_local_session_message",
"id": "clsm_01J4KpLmNoPqRsTuVwXyZaBf",
"role": "assistant",
"model": "claude-opus-5-5",
"created_at": "2026-07-09T14:02:38Z",
"provenance": null,
"content": [
{
"type": "text",
"text": "The test was asserting on a stale expiry timestamp. I've updated it.",
"truncated": false
}
]
}
],
"next_page": null
}Ответ содержит обёртку session наряду с массивом data с пагинацией. Первая запись в этом примере — маркер, заменяющий системную подсказку запроса; его provenance описывается далее в этом разделе. В этой конечной точке user.email_address всегда равен null: конечная точка сообщений не разрешает адреса электронной почты, поэтому null здесь не означает, что учётная запись пользователя была удалена. Чтобы сопоставить сеанс с адресом электронной почты, соедините user.id с данными конечной точки списка или конечной точки получения (GET /v1/compliance/apps/sessions/local/{session_id}).
По умолчанию сообщения возвращаются начиная с самых старых; передайте order=desc, чтобы изменить порядок на обратный. Пагинация использует ту же схему page/next_page, что и конечная точка списка, со значением limit по умолчанию 100 и максимумом 1 000. Страница может закончиться раньше, когда ответ достигает своего ограничения по размеру, поэтому страница с количеством сообщений меньше limit не означает, что вы достигли конца; продолжайте пагинацию, пока next_page не станет null. Курсоры страниц привязаны к сеансу и порядку сортировки, для которых они были выданы, а курсоры обхода истекают через 24 часа после его первой страницы: истёкший курсор возвращает 400 Bad Request с указанием начать заново без параметра page, и перезапущенный обход отражает текущую границу хранения. Курсор, выданный для другого сеанса или другого order, также возвращает 400 как недействительный курсор.
Для очень большого сеанса конечная точка сообщений может вернуть 400 для страницы с сообщением о том, что страница слишком велика для чтения; см. Страница расшифровки слишком велика. Не повторяйте этот запрос. Если в нём использовался order=desc, вместо этого читайте этот сеанс начиная с самых старых сообщений с его первой страницы, без order и без page, и установите тайм-аут запроса вашего клиента не менее 5 минут. Если страница в порядке от старых к новым возвращает ту же ошибку, что делать, описано в соответствующей записи руководства по ошибкам.
Для очень большого сеанса конечная точка сообщений также может вернуть 429, у которого error.details.error_code равен transcript_read_server_busy. Это не означает, что ваша организация превысила ограничение скорости. В отличие от 400, этот запрос следует повторить: подождите количество секунд, указанное в заголовке retry-after, затем отправьте тот же запрос снова без изменений (с тем же значением page, если оно было). См. Сервер занят чтением больших расшифровок.
Каждое сообщение содержит role (user или assistant) и массив content из блоков text, tool_use и tool_result. Оно также содержит model: для хода ассистента, захваченного из Claude API, это модель, которая обслужила этот ход. model равен null в пользовательских сообщениях и в любом сообщении ассистента, у которого задан provenance, поскольку история, заявленная клиентом, и синтетические маркеры не были созданы моделью, а обслуживающая модель для недоступного содержимого неизвестна. Блок text содержит text и truncated. Блок tool_use содержит id, name, input и truncated, где input — это строка в кодировке JSON, а не объект. Блок tool_result содержит tool_use_id, name, is_error, массив content из записей text и truncated. Вызовы и результаты инструментов MCP, а также большинство вызовов и результатов серверных инструментов нормализуются в те же формы tool_use и tool_result; любой другой тип блока отображается как заполнитель [<block type> content not shown]. id сообщения стабилен, пока ход хранится. Каждое сообщение, восстановленное из одного и того же вызова инференса, несёт метку времени этого вызова, поэтому последовательные сообщения часто имеют одинаковое значение created_at; сохраняйте возвращённый порядок, а не пересортировывайте по метке времени.
Каждое сообщение также содержит поле provenance, описывающее, как было собрано его содержимое. provenance равно null для проверенного содержимого, собранного Claude API, что является обычным случаем. В противном случае это объект, type которого обозначает исключение:
content_unavailableозначает, что содержимое не может быть возвращено. Массивcontentпуст, аprovenance.reasonуказывает причину.not_capturedозначает, что для хода нет доступного содержимого. Это не доказывает, что запись не сохранялась: содержимое, которое политики обработки данных Anthropic не передают в Compliance API, сообщается с той же причиной, как и отдельные ходы в остальном захваченного сеанса, недоступные по таким причинам. Непригодный для использования ключ, управляемый клиентом, — единственное исключение: вместо этого возвращается 503 Service Unavailable.client_abortedозначает, что клиент закрыл соединение или отменил запрос до завершения ответа, поэтому ответ хода не был захвачен; любой частичный вывод, уже переданный клиенту в режиме потоковой передачи, не включается, и эта причина применяется только к ходам с ролью ассистента.cmek_key_revokedзарезервирован для содержимого, зашифрованного ключом вашей организации, управляемым клиентом, когда этот ключ недоступен (например, отозван). В настоящее время он не возвращается, поскольку непригодный ключ вместо этого приводит к 503, но обрабатывайте его для прямой совместимости.retention_elapsedозначает, что содержимое вышло за пределы срока хранения.oversizeозначает, что одно сообщение превысило ограничение размера на сообщение; сообщение всё равно возвращается с пустым массивомcontent.client_assertedпомечает сообщения ассистента, которые клиент предоставил как историю разговора и которые не удалось сопоставить с собранным ответом; их авторство не проверено.synthetic_markerпомечает записи, созданные самой конечной точкой, например маркер, заменяющий системную подсказку. Когда клиент переписывает или сжимает историю разговора посреди сеанса (например, после «context compaction» (сжатия контекста)), стенограмма вставляет в этом месте сообщение-маркер и продолжается новым содержимым, отправленным клиентом. Если у вашей организации конечный период хранения и это новое содержимое включает сообщения ассистента, стенограмма скрывает новое содержимое вплоть до его последнего сообщения ассистента включительно (это отмечается вторым маркером) и показывает только пользовательские сообщения после этой точки, за которыми следует остальная часть сеанса.
Сообщения-маркеры и сообщения, заявленные клиентом, начинаются с пояснительного блока text в квадратных скобках с флагом truncated: true, например [system prompt content not shown]. Рассматривайте такие записи как присутствующие, но недоступные или непроверенные, а не как отсутствующие, и допускайте нераспознанные типы и причины provenance.
Два параметра ограничивают количество возвращаемых байтов каждого блока инструмента: tool_use_input_max_bytes и tool_result_max_bytes, оба по умолчанию равны 10 000 байт. Передайте -1 для серверного максимума (около 1 МиБ для каждой строки); 0 возвращает 400 Bad Request, а значения выше максимума приводятся к нему. Строка, обрезанная любым из ограничений, обрезается по границе символа, к ней добавляется встроенный суффикс (например, …[truncated; pass tool_result_max_bytes=-1 for the server max]), а её блок содержит "truncated": true. Поэтому усечённый input блока tool_use больше не является допустимым JSON, так что анализируйте входные данные инструментов только из неусечённых блоков (или увеличьте ограничение и получите данные повторно). Блоки типа text всегда ограничены тем же серверным максимумом около 1 МиБ; ни один параметр его не увеличивает, и блок text, достигший этого предела, также содержит "truncated": true.
Claude Science вызывает коннекторы (серверы MCP) из кода, который он выполняет через свой инструмент repl, а не как отдельно именованные инструменты, поэтому ни один блок в стенограмме Claude Science не назван по имени коннектора. Каждый вызов коннектора отображается в коде внутри input блока tool_use инструмента repl (например, вызов host.mcp("<server>", "<tool>", ...)), а вывод коннектора отображается в соответствующем tool_result только там, где этот код его напечатал. Сеансы Cowork и Claude Code отличаются: они вызывают каждый инструмент коннектора под его собственным именем mcp__<server>__<tool>, которое является name блока tool_use. Чтобы отслеживать использование коннекторов в сеансах Claude Science, разбирайте строку input и сопоставляйте по содержащемуся в ней коду, а не по имени инструмента. Передавайте tool_use_input_max_bytes=-1 для этих сеансов, чтобы длинный входной код возвращался вплоть до серверного максимума, а не обрезался на значении по умолчанию в 10 000 байт до того, как появится вызов коннектора.
Содержимое стенограммы соответствует сроку хранения, описанному в разделе Сеансы на компьютерах пользователей. Когда самые ранние вызовы сеанса выходят за пределы этого срока, стенограмма начинается с одного заполнителя content_unavailable с reason, равным retention_elapsed, за которым следуют сохранённые сообщения. Когда все вызовы в сеансе устаревают, конечная точка сообщений возвращает 404 Not Found, как и для сеансов в организациях, которые ваш ключ не может читать, несуществующих сеансов и сеансов, для которых действует нулевое хранение данных. Неправильно сформированный ID сеанса возвращает 400 Bad Request.
Сеансы в облаке (удалённые сеансы)
Сеансы Cowork, запущенные в веб-версии или мобильном приложении claude.ai, и сеансы Claude Tag, запущенные в Slack, выполняются в облаке в средах, управляемых Anthropic; сеансы Claude Tag также могут выполняться в пуле самостоятельно размещённых исполнителей. Compliance API предоставляет доступ к этим удалённым сеансам через две конечные точки: GET /v1/compliance/apps/sessions/remote возвращает список метаданных сеансов, а GET /v1/compliance/apps/sessions/remote/{session_id}/messages возвращает стенограмму одного сеанса. Обе требуют области read:compliance_user_data, и обе учитываются в общем ограничении скорости Compliance API, а также в отдельном бюджете запросов, специфичном для этих конечных точек; см. 429 Too Many Requests.
Конечная точка списка по умолчанию охватывает всю организацию: не указывайте organization_ids[], чтобы включить все организации claude.ai, доступные для чтения вашему ключу, или передайте до 500 значений, чтобы сузить охват. Чтобы вместо этого ограничить список конкретными пользователями, передайте от 1 до 10 значений user_ids[] (получите идентификаторы через Список пользователей организации); фильтр сопоставляется с пользователем-владельцем сеанса, поэтому сеансы, принадлежащие агентам, включая принадлежащие агентам сеансы Claude Tag, исключаются всякий раз, когда задан user_ids[]. Ограничьте результаты по времени с помощью параметров диапазона created_at (gte, gt, lt, lte в формате RFC 3339). Фильтра updated_at нет. Следующий запрос возвращает список сеансов, созданных начиная с заданной даты.
curl --fail-with-body -sS -G \
"https://api.anthropic.com/v1/compliance/apps/sessions/remote" \
-H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
-H "anthropic-version: 2026-10-21" \
--data-urlencode "created_at.gte=2026-06-01T00:00:00Z" \
--data-urlencode "limit=100"{
"data": [
{
"id": "cse_01WpQrStUvXyZaBcDeFgHjK6",
"organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
"user": {
"id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
"email_address": "user@example.com"
},
"agent_id": null,
"started_by_user": null,
"status": "active",
"created_at": "2026-07-01T17:04:05Z",
"updated_at": "2026-07-01T18:00:41Z",
"product_surface": "cowork_remote",
"claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
},
{
"id": "cse_01TkNpRsUvWxYzAbCdEfGhJ4",
"organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
"user": {
"id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
"email_address": "user@example.com"
},
"agent_id": null,
"started_by_user": null,
"status": "archived",
"created_at": "2026-06-28T09:15:22Z",
"updated_at": "2026-06-28T09:47:10Z",
"product_surface": "cowork_remote",
"claude_project_id": null
}
],
"next_page": "page_AAEfMk93cXpYdGxrZXk"
}Результаты отсортированы в обратном хронологическом порядке (сначала новые) по created_at и ограничены limit результатами в каждом ответе (по умолчанию 100, максимум 500). Конечная точка использует постраничную разбивку с токенами page и next_page (см. Постраничная навигация по результатам): передайте значение next_page из ответа в качестве параметра запроса page в следующем запросе и остановитесь, когда next_page равно null.
Сеанс принадлежит либо пользователю, либо агенту, но никогда обоим одновременно. Для сеансов, принадлежащих пользователям, user содержит идентификатор и адрес электронной почты владельца (email_address равно null, если пользователь больше не является участником организации, доступной для чтения вашему ключу), а agent_id равно null. Для сеансов, принадлежащих агентам (например, сеанса Claude Tag, запущенного упоминанием в Slack), user равно null, а agent_id содержит идентификатор агента (префикс cagt_). В таких сеансах started_by_user указывает человека, запустившего сеанс, если он записан, поэтому в сеансе Claude Tag оно может быть равно null. В сеансах, принадлежащих пользователям, started_by_user равно null.
Каждый запуск запланированной задачи Cowork в облаке происходит в сеансе, у которого тот же владелец, что и у задачи. Когда пользователь создаёт задачу в Cowork, такие сеансы принадлежат пользователю: user указывает этого пользователя, а agent_id и started_by_user равны null. Фильтр user_ids[], в котором указан этот пользователь, находит эти сеансы. Запуск может начать новый сеанс или продолжить существующий. Когда запуск продолжает существующий сеанс, created_at этого сеанса — это время начала сеанса, а не время запуска. Ни одно поле сеанса не помечает сеанс как запланированный запуск и не содержит название или расписание задачи.
claude_project_id — это идентификатор проекта claude.ai, к которому относится сеанс (префикс claude_proj_), или null, если сеанс не входит в проект.
status принимает одно из значений pending, active, paused, archived или failed. Сеанс находится в состоянии pending, пока он подготавливается; у сеанса в состоянии pending ещё нет стенограммы, и конечная точка сообщений возвращает для него 404, пока подготовка не завершится. Удалённые сеансы никогда не возвращаются.
product_surface (строка или null) указывает продукт, создавший сеанс. В настоящее время конечная точка возвращает сеансы с одним из двух значений product_surface. cowork_remote — для сеансов Cowork в облаке, включая сеансы, запущенные в веб-версии или мобильном приложении claude.ai, и облачные запуски запланированных задач Cowork. claude_tag — для сеансов Claude Tag, запущенных в Slack.
Чтобы получить чат в едином интерфейсе Claude, включая часть, выполнявшуюся в облаке, используйте конечные точки чатов (Получение сообщений чатаДоступен предпросмотр со ссылками на справочник API — нажимайте Tab, пока фокус не перейдет на карточку; чтобы вернуться, нажмите Escape.), а не конечные точки удалённых сеансов. Список удалённых сеансов также возвращает сеансы, в которых продолжается такой чат, со значением cowork_remote, поэтому при экспорте и чатов, и удалённых сеансов эта работа попадёт в экспорт дважды.
Получение стенограммы удалённого сеанса
Конечная точка сообщений возвращает стенограмму сеанса: подсказки пользователя, ответы ассистента, а также вызовы инструментов и их результаты. Блоки размышлений и изображения не включаются. Сводку о том, какие данные охватываются, см. в разделе Часто задаваемые вопросы о Compliance API. Таблица, сравнивающая удалённые сеансы с локальными сеансами и журналированием OpenTelemetry в Cowork, приведена во введении к этой странице.
curl --fail-with-body -sS \
"https://api.anthropic.com/v1/compliance/apps/sessions/remote/cse_01WpQrStUvXyZaBcDeFgHjK6/messages" \
-H "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
-H "anthropic-version: 2026-10-21"{
"session": {
"id": "cse_01WpQrStUvXyZaBcDeFgHjK6",
"organization_uuid": "91012d09-e48b-438e-a489-1bebfd8fa6f9",
"user": {
"id": "user_01WxYzAbCdEfGhJkMnPqRsTu",
"email_address": null
},
"agent_id": null,
"started_by_user": null,
"status": "active",
"created_at": "2026-07-01T17:04:05Z",
"updated_at": "2026-07-01T18:00:41Z",
"product_surface": "cowork_remote",
"claude_project_id": null
},
"data": [
{
"id": "csev_01HjKmNpQrStUvWxYzAbCdE2",
"role": "user",
"created_at": "2026-07-01T17:04:05Z",
"content": [
{
"type": "text",
"text": "Summarize the customer feedback in the attached spreadsheet.",
"truncated": false
}
],
"sent_by_user_id": null,
"content_unavailable": false
},
{
"id": "csev_01BcDeFgHjKmNpQrStUvWxY4",
"role": "assistant",
"created_at": "2026-07-01T17:04:06Z",
"content": [
{
"type": "text",
"text": "I'll start by reading the spreadsheet...",
"truncated": false
}
],
"sent_by_user_id": null,
"content_unavailable": false
}
],
"next_page": null
}Помимо постраничного массива data, ответ содержит вложенный объект session. В этой конечной точке поля user.email_address, started_by_user и claude_project_id в этом объекте всегда равны null. Получайте эти значения через конечную точку списка.
По умолчанию сообщения возвращаются начиная с самых старых; чтобы изменить порядок, передайте order=desc. Постраничная выдача работает по той же схеме page/next_page, что и в конечной точке списка. Значение limit по умолчанию равно 100, максимум — 1 000. Страница может закончиться раньше, если ответ достиг предельного размера. Поэтому страница, содержащая меньше limit сообщений, ещё не означает, что вы дошли до конца. Продолжайте запрашивать страницы, пока next_page не станет равным null.
Каждое сообщение содержит поле role (user или assistant) и массив content из блоков text, tool_use и tool_result. Значения created_at у сообщений — это временные метки фиксации. У последовательных сообщений метки могут совпадать или идти в слегка обратном порядке, поэтому сохраняйте порядок из ответа, а не пересортировывайте сообщения по created_at. В сеансах, принадлежащих агенту, поле sent_by_user_id указывает пользователя, отправившего данное пользовательское сообщение, если его можно установить. В остальных случаях, в том числе во всех сообщениях ассистента, оно равно null. Если содержимое сообщения вообще невозможно вернуть (например, оно превышает допустимый размер), у сообщения поле content_unavailable равно true.
Два параметра ограничивают количество возвращаемых байтов каждого блока инструмента: tool_use_input_max_bytes и tool_result_max_bytes, оба по умолчанию равны 10 000 байт. Передайте -1, чтобы использовать максимум сервера (около 1 МиБ для каждой строки); значение 0 возвращает 400 Bad Request. Блок, обрезанный любым из ограничений, содержит "truncated": true, а обрезанные входные данные tool_use больше не являются допустимым JSON, поэтому разбирайте входные данные инструментов только из необрезанных блоков (или увеличьте ограничение и запросите данные повторно).
Конечная точка сообщений возвращает 404 Not Found для сеансов в состоянии pending, для несуществующих или удалённых сеансов, а также для сеансов в организациях, которые ваш ключ не может читать.
Хранение и удаление
Конечные точки сеансов доступны только для чтения; локальные и удалённые сеансы нельзя удалить через них. Стенограммы локальных сеансов по умолчанию хранятся 6 лет, либо в течение пользовательского срока хранения разговоров вашей организации, если задан конечный срок, либо 30 дней в организациях с включённой готовностью к HIPAA, как описано в разделе Сеансы на компьютерах пользователей.
У стенограмм удалённых сеансов (например, Cowork в облаке) нет срока хранения по умолчанию. Сеансы в облаке, которые Claude запускает из чата, удаляются вместе с чатом, в том числе когда его удаляет пользовательский срок хранения разговоров вашей организации.
У стенограмм сеансов Claude Tag также нет срока хранения по умолчанию. Они удаляются, когда канал удаляется из Claude Tag, когда канал удаляется в Slack, когда отключается рабочее пространство Slack или Enterprise Grid, а также когда приложение Slack удаляется из рабочего пространства. Удаление установки на уровне всей организации из Enterprise Grid их не удаляет. Экспортируйте все стенограммы Claude Tag, которые вам необходимо сохранить, прежде чем удалять канал или отключать рабочее пространство.
После удаления сеанса конечные точки удалённых сеансов больше его не возвращают, и его стенограмму невозможно восстановить через Compliance API. Чтобы узнать, как хранение сеансов соотносится с другими условиями хранения Anthropic, см. API и хранение данных.
Дальнейшие шаги
Получайте доступ к содержимому чатов claude.ai, вложенным файлам и проектам с помощью того же Compliance Access Key.
Сводка по полям о том, что входит в стенограммы сеансов, и ответы на другие распространённые вопросы.
Точные тексты ответов с ошибками и способы устранения каждой из них.
Пути конечных точек, параметры и схемы ответов Compliance API.
Эта страница была полезной?