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 Messages 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 de Projetos (OpenAI-compatible) — eles são gerenciados usando a API Projects e fornecem os mesmos recursos:

Os espaços de trabalho permitem que você gerencie várias cargas de trabalho de IA generativas em 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 padrão (projeto) ao qual todas as solicitações de inferência são associadas. Você pode criar espaços de trabalho adicionais usando a API Projects e referenciá-los nas solicitações da API Messages usando o anthropic-workspace cabeçalho.

Quando usar espaços de trabalho

Você deve usar o Workspaces quando precisar:

Espaços de trabalho versus projetos

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

Começando com o Workspaces

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

Pré-requisitos

Antes de começar, você deve ter o seguinte:

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 Projects. 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 a mesma ID de espaço de trabalho são agrupadas, permitindo o rastreamento de custos por espaço de trabalho, controle de acesso e observabilidade.

Etapa 4: verificar 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 de espaço de trabalho recomendada

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