기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Workspaces(Anthropic 호환)

Amazon Bedrock Workspaces는 bedrock-mantle 엔드포인트에서 Anthropic 호환 메시지 API를 사용하여 생성형 AI 워크로드에 대한 애플리케이션 수준 격리를 제공합니다. Workspace를 사용하면 비용 추적, 관찰성 및 액세스 제어를 위해 AI 애플리케이션을 세분화할 수 있습니다.

Workspace란 무엇입니까?

Workspace는 Anthropic Messages API를 사용할 때 Amazon Bedrock 내에서 애플리케이션, 환경 또는 실험과 같은 워크로드를 격리하는 데 사용되는 논리적 경계입니다. Workspace는와 동일한 기본 리소스입니다. 프로젝트(OpenAI 호환) 즉, Projects API를 사용하여 관리되며 동일한 기능을 제공합니다.

Workspace를 사용하면 별도의 AWS 계정 또는 조직을 생성하지 않고도 프로덕션 환경에서 여러 생성형 AI 워크로드를 관리할 수 있으므로 보안 및 거버넌스를 유지하면서 운영 복잡성을 줄일 수 있습니다.

각 AWS 계정에는 모든 추론 요청이 연결된 기본 워크스페이스(프로젝트)가 있습니다. 프로젝트 API를 사용하여 추가 워크스페이스를 생성하고 anthropic-workspace 헤더를 사용하여 메시지 API 요청에서 참조할 수 있습니다.

Workspace를 사용해야 하는 경우

다음과 같은 경우 Workspace를 사용해야 합니다.

Workspace와 프로젝트 비교

Workspace와 프로젝트(OpenAI 호환)는 동일한 기본 리소스이며, 둘 다 프로젝트 API를 통해 관리됩니다. 차이점은 사용하는 API에 따라 추론 요청에서 이를 참조하는 방법입니다.

Workspace 시작하기

이 섹션에서는 워크스페이스를 생성하고, 이를 Messages API 요청과 연결하고, 설정을 확인하는 방법을 안내합니다.

사전 조건

시작하기 전에 다음을 갖추었는지 확인하세요.

1단계: 환경 설정

Amazon Bedrock 자격 증명을 사용하여 환경 변수를 구성합니다.

export BEDROCK_API_KEY="<your-bedrock-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를 통해 관리되므로 모든 프로젝트 관리 작업이 적용됩니다. 프로젝트 작업 다음에 대한 자세한 지침은 섹션을 참조하세요.

모범 사례

권장 Workspace 구조

애플리케이션당 하나의 워크스페이스: 각 개별 애플리케이션 또는 서비스에 대해 별도의 워크스페이스를 생성합니다.

├── Claude-Chatbot-Production
├── Claude-Chatbot-Staging
├── Claude-Chatbot-Development
├── Claude-Summarizer-Production
└── Claude-Summarizer-Development

Workspace 수명 주기 관리