기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Workspaces(Anthropic 호환)
Amazon Bedrock Workspaces는 `bedrock-mantle` 엔드포인트에서 Anthropic 호환 메시지 API를 사용하여 생성형 AI 워크로드에 대한 애플리케이션 수준 격리를 제공합니다. Workspace를 사용하면 비용 추적, 관찰성 및 액세스 제어를 위해 AI 애플리케이션을 세분화할 수 있습니다.
**참고**
Workspace는 `bedrock-mantle` 엔드포인트에서 메시지 API를 지원하는 모델에만 사용할 수 있습니다. 메시지 API를 지원하는 모델을 확인하려면 섹션을 참조하세요[Amazon Bedrock에서 지원하는 APIs](apis.md).
OpenAI 호환 APIs(응답 API, 채팅 완료)를 사용하는 경우 [프로젝트(OpenAI 호환)](projects.md) 대신를 사용합니다.
## Workspace란 무엇입니까?
Workspace는 Anthropic Messages API를 사용할 때 Amazon Bedrock 내에서 애플리케이션, 환경 또는 실험과 같은 워크로드를 격리하는 데 사용되는 논리적 경계입니다. Workspace는와 동일한 기본 리소스입니다. [프로젝트(OpenAI 호환)](projects.md) 즉, Projects API를 사용하여 관리되며 동일한 기능을 제공합니다.
+ **액세스 격리**: [Amazon Bedrock Projects에 대한 IAM 정책을](security-iam-projects.md) 사용하여 특정 워크스페이스 리소스에 액세스할 수 있는 사용자 제어
+ **비용 모니터링**: [AWS 태그](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/what-are-tags.html) 및 [AWS Cost Explorer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-what-is.html)를 사용하여 워크스페이스 수준에서 지출 추적
+ **관찰성**: 모니터링 및 최적화를 위해 워크스페이스당 사용량 지표 및 패턴을 추적합니다.
Workspace를 사용하면 별도의 AWS 계정 또는 조직을 생성하지 않고도 프로덕션 환경에서 여러 생성형 AI 워크로드를 관리할 수 있으므로 보안 및 거버넌스를 유지하면서 운영 복잡성을 줄일 수 있습니다.
각 AWS 계정에는 모든 추론 요청이 연결된 기본 워크스페이스(프로젝트)가 있습니다. 프로젝트 API를 사용하여 추가 워크스페이스를 생성하고 `anthropic-workspace` 헤더를 사용하여 메시지 API 요청에서 참조할 수 있습니다.
## Workspace를 사용해야 하는 경우
다음과 같은 경우 Workspace를 사용해야 합니다.
+ **비즈니스 구조별 구성**: 사업부, 팀, 애플리케이션 또는 비용 센터와 같은 조직 분류를 기반으로 Amazon Bedrock 사용량 관리
+ **비용을 정확하게 추적**: AI 지출을 모니터링하고 특정 팀, 프로젝트 또는 환경에 할당
+ **액세스 정책 적용**: 세분화된 IAM 권한을 적용하여 특정 AI 워크로드에 액세스할 수 있는 사용자를 제어합니다.
+ **프로덕션 워크로드 규모 조정**: 명확한 운영 경계 및 모니터링으로 여러 프로덕션 애플리케이션 실행
## Workspace와 프로젝트 비교
Workspace와 [프로젝트(OpenAI 호환)](projects.md)는 동일한 기본 리소스이며, 둘 다 프로젝트 API를 통해 관리됩니다. 차이점은 사용하는 API에 따라 추론 요청에서 이를 참조하는 방법입니다.
| 기능 | 워크스페이스 | Projects |
| --- | --- | --- |
| 지원되는 API | Anthropic Messages API | OpenAI 호환 APIs(응답, 채팅 완료) |
| 엔드포인트 | bedrock-mantle.{region}.api.aws/anthropic/v1/messages | bedrock-mantle.{region}.api.aws/v1 |
| 헤더 | anthropic-workspace: {project-id} | OpenAI-Project: {project-id} |
| 관리 API | 프로젝트 API | 프로젝트 API |
| 액세스 통제 | IAM 정책의 리소스로 프로젝트 | IAM 정책의 리소스로 프로젝트 |
| 비용 추적 | AWS 프로젝트의 태그 | AWS 프로젝트의 태그 |
## Workspace 시작하기
이 섹션에서는 워크스페이스를 생성하고, 이를 Messages API 요청과 연결하고, 설정을 확인하는 방법을 안내합니다.
### 사전 조건
시작하기 전에 다음을 갖추었는지 확인하세요.
+ Amazon Bedrock 액세스 권한이 있는 AWS 계정
+ Amazon Bedrock 프로젝트를 생성하고 관리할 수 있는 IAM 권한
+ Amazon Bedrock 인증을 위한 [API 키](api-keys.md)
+ Claude 모델에 대한 액세스( 참조[모델에 대한 액세스 요청](model-access.md))
### 1단계: 환경 설정
Amazon Bedrock 자격 증명을 사용하여 환경 변수를 구성합니다.
```
export BEDROCK_API_KEY=""
export BEDROCK_REGION="us-east-1"
```
### 2단계: Workspace 생성
Workspace는 프로젝트 API를 사용하여 생성됩니다. 비용 모니터링을 위한 이름과 태그를 사용하여 워크스페이스(프로젝트)를 생성합니다.
```
curl -X POST "https://bedrock-mantle.$BEDROCK_REGION.api.aws/v1/organization/projects" \
-H "Authorization: Bearer $BEDROCK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Claude Chatbot Production",
"tags": {
"Application": "CustomerChatbot",
"Environment": "Production",
"Team": "NLPEngineering",
"CostCenter": "41250"
}
}'
```
응답:
```
{
"arn": "arn:aws:bedrock-mantle:us-east-1:123456789012:project/proj_abc123def456",
"created_at": 1772135628,
"id": "proj_abc123def456",
"name": "Claude Chatbot Production",
"object": "organization.project",
"status": "active",
"tags": {
"Application": "CustomerChatbot",
"Environment": "Production",
"Team": "NLPEngineering",
"CostCenter": "41250"
}
}
```
`id` 필드 참고 - `anthropic-workspace` 헤더에 전달하는 값입니다.
### 3단계: Workspace와 요청 연결
Messages API 요청을 워크스페이스와 연결하려면 `anthropic-workspace` 헤더를 프로젝트 ID와 함께 포함합니다.
------
#### [ curl ]
```
curl -X POST "https://bedrock-mantle.$BEDROCK_REGION.api.aws/anthropic/v1/messages" \
-H "x-api-key: $BEDROCK_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-workspace: proj_abc123def456" \
-H "Content-Type: application/json" \
-d '{
"model": "anthropic.claude-sonnet-4-6-v1",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Hello, how can you help me today?"}
]
}'
```
------
#### [ Python (Anthropic SDK) ]
```
import anthropic
client = anthropic.Anthropic(
base_url=f"https://bedrock-mantle.{region}.api.aws/anthropic",
api_key=bedrock_api_key,
)
response = client.messages.create(
model="anthropic.claude-sonnet-4-6-v1",
max_tokens=1024,
extra_headers={"anthropic-workspace": "proj_abc123def456"},
messages=[
{"role": "user", "content": "Hello, how can you help me today?"}
]
)
print(response.content[0].text)
```
------
동일한 워크스페이스 ID로 이루어진 모든 추론 요청은 함께 그룹화되어 워크스페이스당 비용 추적, 액세스 제어 및 관찰성을 지원합니다.
### 4단계: Workspace 설정 확인
모든 워크스페이스(프로젝트)를 나열하여 워크스페이스가 성공적으로 생성되었는지 확인합니다.
```
curl -X GET "https://bedrock-mantle.$BEDROCK_REGION.api.aws/v1/organization/projects" \
-H "Authorization: Bearer $BEDROCK_API_KEY"
```
## Workspace 관리
Workspace는 프로젝트 API를 통해 관리되므로 모든 프로젝트 관리 작업이 적용됩니다. [프로젝트 작업](projects.md#projects-working-with) 다음에 대한 자세한 지침은 섹션을 참조하세요.
+ **워크스페이스 나열**: 계정의 모든 워크스페이스 검색
+ **세부 정보 검색**: 특정 워크스페이스에 대한 정보 가져오기
+ **워크스페이스 업데이트**: 워크스페이스 이름 또는 태그 수정
+ **태그 관리**: 비용 할당을 위한 태그 추가 또는 제거
+ 워크**스페이스 보관**: 더 이상 사용되지 않는 워크스페이스 보관
## 모범 사례
### 권장 Workspace 구조
**애플리케이션당 하나의 워크스페이스**: 각 개별 애플리케이션 또는 서비스에 대해 별도의 워크스페이스를 생성합니다.
```
├── Claude-Chatbot-Production
├── Claude-Chatbot-Staging
├── Claude-Chatbot-Development
├── Claude-Summarizer-Production
└── Claude-Summarizer-Development
```
+ **별도의 환경**: 개발, 스테이징 및 프로덕션 환경에 다른 워크스페이스를 사용합니다.
+ **실험 격리**: 실험 및 proof-of-concepts 위한 전용 작업 영역을 생성합니다.
### Workspace 수명 주기 관리
+ 워크**스페이스 조기 생성**: 애플리케이션을 배포하기 전에 워크스페이스 설정
+ **일관된 이름 지정 사용**: 조직 이름 지정 규칙 준수
+ **비용 할당 태그**: 항상 비용 센터 및 팀 태그 포함
+ **정기 감사**: 사용하지 않는 워크스페이스를 정기적으로 검토 및 보관
+ **사용량 모니터링**: 워크스페이스 지표를 추적하여 최적화 기회 식별