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

Los espacios de trabajo de Amazon Bedrock proporcionan aislamiento a nivel de aplicación para sus cargas de trabajo generativas de IA mediante la API Messages en el Anthropic-compatible punto final. bedrock-mantle Los espacios de trabajo le permiten segmentar sus aplicaciones de IA para el seguimiento de los costos, la observabilidad y el control de 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 en Amazon Bedrock cuando se utiliza la API de mensajes antrópicos. Los espacios de trabajo son el mismo recurso subyacente que el suyoProyectos (OpenAI-compatible): se administran mediante la API de proyectos y ofrecen las mismas capacidades:

Los espacios de trabajo 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 están asociadas 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 Workspaces

Debes usar Workspaces cuando necesites:

Espacios de trabajo frente a proyectos

Los espacios de trabajo Proyectos (OpenAI-compatible) son el mismo recurso subyacente; ambos se administran a través de 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 con Workspaces

En esta sección, se explica cómo crear un espacio de trabajo, asociarlo a las solicitudes de la API de Messages y verificar la configuración.

Requisitos previos

Antes de empezar, asegúrese de que tiene 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: Cree un espacio de trabajo

Los espacios de trabajo se crean mediante la API de proyectos. Crea un espacio de trabajo (proyecto) con un nombre y etiquetas para monitorear los costos:

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

Tenga en cuenta el id campo: este es el valor que se pasa al anthropic-workspace encabezado.

Paso 3: Asocia las solicitudes a tu espacio de trabajo

Para asociar tus solicitudes a la API de Messages 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 realizar el seguimiento de los costes, el control de acceso y la observabilidad por espacio de trabajo.

Paso 4: Verifica la configuración de tu espacio de trabajo

Enumera todos los espacios de trabajo (proyectos) para verificar que tu 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

Dado que los espacios de trabajo se administran a través de la API de proyectos, se aplican todas las operaciones de administració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

Administración del ciclo de vida del espacio