Рабочие пространства

Рабочие пространства предоставляют способ организации использования API в рамках организации. Используйте рабочие пространства для разделения различных проектов, окружений или команд при сохранении централизованного выставления счетов и администрирования.

Как работают рабочие пространства

Каждая организация имеет Рабочее пространство по умолчанию, которое нельзя переименовать, архивировать или удалить. При создании дополнительных рабочих пространств вы можете назначить ключи API, участников и ограничения ресурсов для каждого из них.

Ключевые характеристики:

• Идентификаторы рабочих пространств используют префикс wrkspc_ (например, wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ)
• Максимум 100 рабочих пространств на организацию (архивированные рабочие пространства не учитываются)
• Рабочее пространство по умолчанию не имеет ID и не отображается в конечных точках списка
• Ключи API ограничены одним рабочим пространством и могут получать доступ только к ресурсам в этом рабочем пространстве

Роли и разрешения рабочего пространства

Участники могут иметь разные роли в каждом рабочем пространстве, что позволяет осуществлять детальный контроль доступа.

Наследование ролей

• Администраторы организации автоматически получают доступ Workspace Admin ко всем рабочим пространствам
• Члены организации, отвечающие за выставление счетов автоматически получают доступ Workspace Billing ко всем рабочим пространствам
• Пользователи и разработчики организации должны быть явно добавлены в каждое рабочее пространство

Управление рабочими пространствами

Через Claude Console

Создавайте и управляйте рабочими пространствами в Claude Console.

Создание рабочего пространства

Редактирование деталей рабочего пространства

Для изменения имени или цвета рабочего пространства:

1. Выберите рабочее пространство из списка
2. Нажмите меню многоточия (...) и выберите Edit details
3. Обновите имя или цвет и сохраните изменения

Добавление участников в рабочее пространство

1. Перейдите на вкладку Members рабочего пространства
2. Нажмите Add to Workspace
3. Выберите участника организации и назначьте ему роль рабочего пространства
4. Подтвердите добавление

Для удаления участника нажмите значок корзины рядом с его именем.

Установка ограничений рабочего пространства

На вкладке Limits вы можете настроить:

• Rate limits: Установите ограничения по уровню модели для запросов в минуту, входных токенов или выходных токенов
• Spend notifications: Настройте оповещения при достижении определенных пороговых значений расходов

Архивирование рабочего пространства

Для архивирования рабочего пространства нажмите меню многоточия (...) и выберите Archive. Архивирование:

• Сохраняет исторические данные для отчетности
• Деактивирует рабочее пространство и все связанные ключи API
• Не может быть отменено

Через Admin API

Программно управляйте рабочими пространствами с помощью Admin API.

# Create a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"name": "Production"}'

# List workspaces
curl "https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

# Archive a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Для получения полной информации о параметрах и схемах ответов см. справочник API рабочих пространств.

Управление участниками рабочего пространства

Добавляйте, обновляйте или удаляйте участников из рабочего пространства:

# Add a member to a workspace
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{
    "user_id": "user_xxx",
    "workspace_role": "workspace_developer"
  }'

# Update a member's role
curl --request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY" \
  --data '{"workspace_role": "workspace_admin"}'

# Remove a member from a workspace
curl --request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Для получения полной информации о параметрах см. справочник API участников рабочего пространства.

Ключи API и область действия ресурсов

Ключи API ограничены определенным рабочим пространством. При создании ключа API в рабочем пространстве он может получать доступ только к ресурсам в этом рабочем пространстве.

Ресурсы, ограниченные рабочими пространствами, включают:

• Файлы созданные через Files API
• Message Batches созданные через Batch API
• Skills созданные через Skills API

Ограничения рабочего пространства

Вы можете установить пользовательские ограничения расходов и скорости для каждого рабочего пространства, чтобы защитить от чрезмерного использования и обеспечить справедливое распределение ресурсов.

Установка ограничений рабочего пространства

Ограничения рабочего пространства могут быть установлены ниже (но не выше) ограничений вашей организации:

• Ограничения расходов: Ограничьте ежемесячные расходы для рабочего пространства
• Rate limits: Ограничьте запросы в минуту, входные токены в минуту или выходные токены в минуту

Для получения подробной информации о ограничениях скорости и их работе см. Rate limits.

Отслеживание использования и затрат

Отслеживайте использование и затраты по рабочим пространствам с помощью Usage and Cost API:

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
group_by[]=workspace_id&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Использование и затраты, отнесенные к рабочему пространству по умолчанию, имеют значение null для workspace_id.

Типичные варианты использования

Разделение окружений

Создавайте отдельные рабочие пространства для разработки, промежуточного тестирования и производства:

Изоляция команды или отдела

Назначайте рабочие пространства разным командам для распределения затрат и контроля доступа:

• Команда инженеров с доступом разработчика
• Команда науки о данных с собственными ключами API
• Команда поддержки с ограниченным доступом для инструментов клиентов

Организация на основе проектов

Создавайте рабочие пространства для конкретных проектов или продуктов для отдельного отслеживания использования и затрат.

Лучшие практики

Часто задаваемые вопросы

См. также

• Обзор Admin API
• Справочник Admin API
• Rate limits
• Usage and Cost API