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.
**nota**
Os espaços de trabalho só podem ser usados com modelos compatíveis com a API de mensagens no `bedrock-mantle` endpoint. Para ver quais modelos são compatíveis com a API de mensagens, consulte[APIs suportadas pelo Amazon Bedrock](apis.md).
Se você estiver usando as OpenAI-compatible APIs (API de respostas, conclusão de bate-papo), use [Projetos (OpenAI-compatible)](projects.md) em vez disso.
## 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)](projects.md) — eles são gerenciados usando a API de projetos e fornecem os mesmos recursos:
+ **Isolamento de acesso**: controle quem pode acessar recursos específicos do espaço de trabalho usando [políticas do IAM para projetos Amazon Bedrock](security-iam-projects.md)
+ **Monitoramento de custos**: acompanhe os gastos no nível do espaço de trabalho usando [tags da AWS](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/what-are-tags.html) e o [AWS Cost Explorer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-what-is.html)
+ **Observabilidade**: acompanhe métricas e padrões de uso por espaço de trabalho para monitoramento e otimização.
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:
+ **Organize por estrutura de negócios**: gerencie o uso do Amazon Bedrock com base em sua taxonomia organizacional, como unidades de negócios, equipes, aplicativos ou centros de custo
+ **Monitore os custos com precisão**: monitore e aloque os gastos com IA para equipes, projetos ou ambientes específicos
+ **Aplique políticas de acesso: aplique permissões granulares do IAM para controlar quem pode acessar cargas de trabalho** específicas de IA
+ **Dimensione as cargas de trabalho de produção**: execute vários aplicativos de produção com limites operacionais e monitoramento claros
## Espaços de trabalho versus projetos
Espaços de trabalho e [Projetos (OpenAI-compatible)](projects.md) 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:
| Recurso | Espaços de trabalho | Projetos |
| --- | --- | --- |
| APIs aceitas do : | API de mensagens antrópicas | OpenAI-compatible APIs (respostas, conclusões de bate-papo) |
| Endpoint | bedrock-mantle.{region}.api.aws/anthropic/v1/messages | bedrock-mantle.{region}.api.aws/v1 |
| Cabeçalho | anthropic-workspace: {project-id} | OpenAI-Project: {project-id} |
| API de gerenciamento | API de projetos | API de projetos |
| Controle de acesso | Projeto como recurso nas políticas do IAM | Projeto como recurso nas políticas do IAM |
| Controle de custos | AWS tags em projetos | AWS tags em projetos |
## 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:
+ Uma AWS conta com acesso ao Amazon Bedrock
+ Permissões do IAM para criar e gerenciar projetos do Amazon Bedrock
+ Uma [chave de API](api-keys.md) para autenticação do Amazon Bedrock
+ Acesso aos modelos Claude (consulte[Solicitar acesso aos modelos](model-access.md))
### Etapa 1: configurar o ambiente
Configure suas variáveis de ambiente com suas credenciais do Amazon Bedrock:
```
export BEDROCK_API_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](projects.md#projects-working-with) para obter instruções detalhadas sobre:
+ **Listando espaços de trabalho**: recupere todos os espaços de trabalho em sua conta
+ **Recuperando detalhes**: obtenha informações sobre um espaço de trabalho específico
+ **Atualizando espaços de trabalho**: modifique o nome ou as tags do espaço de trabalho
+ **Gerenciamento de tags**: adicione ou remova tags para alocação de custos
+ **Arquivamento de espaços de trabalho**: arquive espaços de trabalho que não estão mais em uso
## 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
```
+ **Ambientes separados**: use diferentes espaços de trabalho para ambientes de desenvolvimento, preparação e produção.
+ **Isolamento de experimentos**: crie espaços de trabalho dedicados para experimentos e provas de conceitos.
### Gerenciamento do ciclo de vida do espaço de trabalho
+ **Crie espaços de trabalho com antecedência**: configure espaços de trabalho antes de implantar aplicativos
+ **Use nomenclatura consistente: siga as convenções** de nomenclatura organizacional
+ **Tag para alocação de custos**: sempre inclua etiquetas do centro de custos e da equipe
+ **Auditorias regulares**: revise e arquive periodicamente espaços de trabalho não utilizados
+ **Monitore o uso**: acompanhe as métricas do espaço de trabalho para identificar oportunidades de otimização