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.

¿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 subyacenteProyectos (OpenAI-compatible): se administran mediante la API de proyectos y ofrecen las mismas capacidades:

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:

Espacios de trabajo frente a proyectos

Los espacios de trabajo y Proyectos (OpenAI-compatible) 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:

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:

Paso 1: configurar el entorno

Configure las variables de entorno con sus credenciales de Amazon Bedrock:

export BEDROCK_API_KEY="<your-bedrock-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 para obtener instrucciones detalladas sobre:

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

Gestión del ciclo de vida del espacio