As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Espaços de trabalho () Anthropic-compatible

O Amazon Bedrock Workspaces fornece isolamento em nível de aplicativo para suas cargas de trabalho generativas de IA usando a API de mensagens no endpoint. Anthropic-compatible bedrock-mantle Os espaços de trabalho permitem que você segmente seus aplicativos de IA para controle de custos, observabilidade e controle de acesso.

O que é um espaço de trabalho?

Um espaço de trabalho é um limite lógico usado para isolar cargas de trabalho, como aplicativos, ambientes ou experimentos no Amazon Bedrock, ao usar a API Anthropic Messages. Os espaços de trabalho são o mesmo recurso subjacente que Projetos (OpenAI-compatible) — eles são gerenciados usando a API de projetos e fornecem os mesmos recursos:

Os espaços de trabalho permitem que você gerencie várias cargas de trabalho generativas de IA na produção sem criar AWS contas ou organizações separadas, reduzindo a complexidade operacional e mantendo a segurança e a governança.

Cada AWS conta tem um espaço de trabalho (projeto) padrão ao qual todas as solicitações de inferência são associadas. Você pode criar espaços de trabalho adicionais usando a API de projetos e referenciá-los nas solicitações da API de mensagens usando o anthropic-workspace cabeçalho.

Quando usar espaços de trabalho

Você deve usar espaços de trabalho quando precisar:

Espaços de trabalho versus projetos

Espaços de trabalho e Projetos (OpenAI-compatible) são o mesmo recurso subjacente — ambos são gerenciados por meio da API de projetos. A diferença é como você faz referência a eles em suas solicitações de inferência, dependendo da API que você usa:

Introdução ao Workspaces

Esta seção explica como criar um espaço de trabalho, associá-lo às solicitações da API de mensagens e verificar sua configuração.

Pré-requisitos

Antes de começar, verifique se você tem:

Etapa 1: configurar o ambiente

Configure suas variáveis de ambiente com suas credenciais do Amazon Bedrock:

export BEDROCK_API_KEY="<your-bedrock-key>"
export BEDROCK_REGION="us-east-1"

Etapa 2: criar um espaço de trabalho

Os espaços de trabalho são criados usando a API de projetos. Crie um espaço de trabalho (projeto) com um nome e tags para monitoramento de custos:

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"
    }
  }'

Resposta:

{
  "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"
  }
}

Observe o id campo — esse é o valor que você passa no anthropic-workspace cabeçalho.

Etapa 3: associar solicitações ao seu espaço de trabalho

Para associar suas solicitações da API de mensagens a um espaço de trabalho, inclua o anthropic-workspace cabeçalho com o ID do projeto:

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)

Todas as solicitações de inferência feitas com o mesmo ID do espaço de trabalho são agrupadas, permitindo o controle de custos, o controle de acesso e a observabilidade por espaço de trabalho.

Etapa 4: verifique a configuração do seu espaço de trabalho

Liste todos os espaços de trabalho (projetos) para verificar se seu espaço de trabalho foi criado com sucesso:

curl -X GET "https://bedrock-mantle.$BEDROCK_REGION.api.aws/v1/organization/projects" \
  -H "Authorization: Bearer $BEDROCK_API_KEY"

Gerenciando espaços de trabalho

Como os espaços de trabalho são gerenciados por meio da API de projetos, todas as operações de gerenciamento de projetos se aplicam. Consulte Como trabalhar com projetos do para obter instruções detalhadas sobre:

Práticas recomendadas

Estrutura recomendada do espaço de trabalho

Um espaço de trabalho por aplicativo: crie espaços de trabalho separados para cada aplicativo ou serviço distinto.

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

Gerenciamento do ciclo de vida do espaço de trabalho