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

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

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

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

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

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

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

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

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

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

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

Через консоль

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

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

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

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

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

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

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

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

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

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

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

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

Чтобы архивировать рабочее пространство, нажмите меню многоточия (...) и выберите 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
• Пакеты сообщений созданные через Batch API
• Навыки созданные через Skills API

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

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

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

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

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

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

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

Отслеживайте использование и затраты по рабочему пространству с помощью 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
• Ограничения скорости
• Usage and Cost API