Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Espacios de trabajo () Anthropic-compatible
Amazon Bedrock Workspaces proporciona aislamiento a nivel de aplicación para sus cargas de trabajo de IA generativa mediante la API de mensajes en el Anthropic-compatible punto final. `bedrock-mantle` Los espacios de trabajo le permiten segmentar sus aplicaciones de IA para realizar un seguimiento de los costes, observarlas y controlar el acceso.
**nota**
Los espacios de trabajo solo se pueden usar con modelos que admitan la API de mensajes en el punto final. `bedrock-mantle` Para ver qué modelos son compatibles con la API de mensajes, consulte[APIs compatibles con Amazon Bedrock](apis.md).
Si utilizas las OpenAI-compatible API (API de respuestas, Chat Completions), utilízalas [Proyectos (OpenAI-compatible)](projects.md) en su lugar.
## ¿Qué es un espacio de trabajo?
Un espacio de trabajo es un límite lógico que se utiliza para aislar cargas de trabajo como aplicaciones, entornos o experimentos dentro de Amazon Bedrock cuando se utiliza la API Anthropic Messages. Los espacios de trabajo son el mismo recurso subyacente[Proyectos (OpenAI-compatible)](projects.md): se administran mediante la API de proyectos y ofrecen las mismas capacidades:
+ **Aislamiento de acceso**: controle quién puede acceder a recursos específicos del espacio de trabajo mediante [las políticas de IAM para los proyectos de Amazon Bedrock](security-iam-projects.md)
+ **Supervisión de costes**: realice un seguimiento de los gastos a nivel de espacio de trabajo mediante [las etiquetas](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/what-are-tags.html) de [AWS y AWS Cost Explorer](https://docs.aws.amazon.com/cost-management/latest/userguide/ce-what-is.html)
+ **Observabilidad**: realice un seguimiento de las métricas y los patrones de uso por espacio de trabajo para monitorizarlos y optimizarlos.
Los espacios de trabajo le permiten gestionar múltiples cargas de trabajo generativas de IA en producción sin crear AWS cuentas u organizaciones independientes, lo que reduce la complejidad operativa y, al mismo tiempo, mantiene la seguridad y la gobernanza.
Cada AWS cuenta tiene un espacio de trabajo (proyecto) predeterminado al que se asocian todas las solicitudes de inferencia. Puedes crear espacios de trabajo adicionales con la API de proyectos y hacer referencia a ellos en las solicitudes de la API de Mensajes mediante el `anthropic-workspace` encabezado.
## Cuándo usar los espacios de trabajo
Deberías usar los espacios de trabajo cuando necesites:
+ **Organice por estructura empresarial**: gestione el uso de Amazon Bedrock en función de la taxonomía de su organización, como unidades de negocio, equipos, aplicaciones o centros de costes
+ **Realice un seguimiento preciso de los costes**: supervise y asigne los gastos de IA a equipos, proyectos o entornos específicos
+ **Haga cumplir las políticas de acceso**: aplique permisos de IAM detallados para controlar quién puede acceder a cargas de trabajo de IA específicas
+ **Amplíe las cargas de trabajo** de producción: ejecute varias aplicaciones de producción con límites operativos y supervisión claros
## Espacios de trabajo frente a proyectos
Los espacios de trabajo y [Proyectos (OpenAI-compatible)](projects.md) los espacios de trabajo son el mismo recurso subyacente; ambos se administran mediante la API de proyectos. La diferencia radica en la forma en que haces referencia a ellos en tus solicitudes de inferencia, según la API que utilices:
| Característica | Espacios de trabajo | Proyectos |
| --- | --- | --- |
| API de compatibles | API de mensajes antrópicos | OpenAI-compatible API (respuestas, finalización de chats) |
| Punto de conexión | bedrock-mantle.{region}.api.aws/anthropic/v1/messages | bedrock-mantle.{region}.api.aws/v1 |
| Encabezado | anthropic-workspace: {project-id} | OpenAI-Project: {project-id} |
| API de administración | API de proyectos | API de proyectos |
| Control de acceso | El proyecto como recurso en las políticas de IAM | El proyecto como recurso en las políticas de IAM |
| Seguimiento de costes | AWS etiquetas en los proyectos | AWS etiquetas en los proyectos |
## Cómo empezar a usar Workspaces
En esta sección, se explica cómo crear un espacio de trabajo, asociarlo a las solicitudes de la API de Mensajes y verificar la configuración.
### Requisitos previos
Antes de comenzar, asegúrese de que dispone de lo siguiente:
+ Una AWS cuenta con acceso a Amazon Bedrock
+ Permisos de IAM para crear y gestionar proyectos de Amazon Bedrock
+ Una [clave de API](api-keys.md) para la autenticación de Amazon Bedrock
+ Acceso a los modelos de Claude (consulte[Solicita acceso a los modelos](model-access.md))
### Paso 1: configurar el entorno
Configure las variables de entorno con sus credenciales de Amazon Bedrock:
```
export BEDROCK_API_KEY=""
export BEDROCK_REGION="us-east-1"
```
### Paso 2: Crea un espacio de trabajo
Los espacios de trabajo se crean mediante la API de proyectos. Cree un espacio de trabajo (proyecto) con un nombre y etiquetas para supervisar los costes:
```
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"
}
}'
```
Respuesta:
```
{
"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"
}
}
```
Fíjate en el `id` campo: es el valor que incluyes en el `anthropic-workspace` encabezado.
### Paso 3: Asocia las solicitudes a tu espacio de trabajo
Para asociar tus solicitudes de la API de mensajes a un espacio de trabajo, incluye el `anthropic-workspace` encabezado con el ID del proyecto:
------
#### [ 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 las solicitudes de inferencia realizadas con el mismo ID de espacio de trabajo se agrupan, lo que permite el seguimiento de los costes por espacio de trabajo, el control de acceso y la observabilidad.
### Paso 4: Verifica la configuración de tu espacio de trabajo
Enumere todos los espacios de trabajo (proyectos) para comprobar que su espacio de trabajo se creó correctamente:
```
curl -X GET "https://bedrock-mantle.$BEDROCK_REGION.api.aws/v1/organization/projects" \
-H "Authorization: Bearer $BEDROCK_API_KEY"
```
## Administrar los espacios de trabajo
Como los espacios de trabajo se administran mediante la API de proyectos, se aplican todas las operaciones de gestión de proyectos. Consulte [Trabajar con proyectos de](projects.md#projects-working-with) para obtener instrucciones detalladas sobre:
+ **Publicar espacios de trabajo**: recupera todos los espacios de trabajo de tu cuenta
+ **Recuperar detalles**: obtén información sobre un espacio de trabajo específico
+ **Actualización de espacios de trabajo**: modifique el nombre o las etiquetas del espacio de trabajo
+ **Administración de etiquetas**: agregue o elimine etiquetas para la asignación de costos
+ **Archivar espacios de trabajo**: archiva los espacios de trabajo que ya no se utilizan
## Prácticas recomendadas
### Estructura de espacio de trabajo recomendada
**Un espacio de trabajo por aplicación**: cree espacios de trabajo independientes para cada aplicación o servicio distinto.
```
├── Claude-Chatbot-Production
├── Claude-Chatbot-Staging
├── Claude-Chatbot-Development
├── Claude-Summarizer-Production
└── Claude-Summarizer-Development
```
+ **Entornos separados: utilice diferentes espacios de trabajo para los entornos** de desarrollo, puesta en escena y producción.
+ **Aislamiento de experimentos**: cree espacios de trabajo específicos para los experimentos y las pruebas de concepto.
### Gestión del ciclo de vida del espacio
+ **Cree espacios de trabajo con antelación**: configure los espacios de trabajo antes de implementar las aplicaciones
+ **Utilice nombres coherentes: siga las convenciones de nomenclatura** de la organización
+ **Etiqueta para la asignación de costos**: incluya siempre las etiquetas del centro de costos y del equipo
+ **Auditorías periódicas**: revise y archive periódicamente los espacios de trabajo no utilizados
+ **Supervise el uso**: realice un seguimiento de las métricas del espacio de trabajo para identificar oportunidades de optimización