Sandboxes에서 에이전트 실행하기

​

대화형 coding agent와 autonomous agent

​

인테그레이션 선택

​

나만의 인테그레이션 구축

​

cws-agent 시작하기

export CWSANDBOX_API_KEY="[API-ACCESS-TOKEN]"

​

샌드박스가 실행될 위치 선택

​

더 긴 세션 실행

​

serverless 샌드박스 수명 설정

import os
from cwsandbox import AuthHeaders, Sandbox

forge_auth = AuthHeaders(
    headers={"x-wandb-api-key": os.environ["FORGE_API_KEY"]},
    strategy="wandb_api_key",
)

sandbox = Sandbox.run(
    auth=forge_auth,
    placement_mode="serverless",
    container_image="python:3.12-slim",
    resources={"cpu": "4", "memory": "8Gi"},
    max_lifetime_seconds=24 * 60 * 60,
)
print(f"Sandbox ID: {sandbox.sandbox_id}")

import { createSandboxClient } from "@coreweave/cwsandbox/wandb";

const client = createSandboxClient({
  apiKey: process.env.FORGE_API_KEY,
});
const sandbox = await client.create({
  containerImage: "python:3.12-slim",
  resources: { cpu: "4", memory: "8Gi" },
  maxLifetimeSeconds: 24 * 60 * 60,
  waitUntilRunning: false,
});
console.log(`Sandbox ID: ${sandbox.sandboxId}`);

cws-agent launch [SANDBOX-NAME] --lifetime 24h --cpu 4 --memory 8Gi --permission-mode native

​

CKS 배치 및 정책 설정

cwic sandbox runner policy edit [RUNNER-ID]

{
  "constraints": {
    "lifecycle": {
      "defaultLifetimeSeconds": 86400
    },
    "resources": {
      "maxCpu": "4",
      "maxMemory": "8Gi"
    }
  }
}

​

실행 시간과 대화 상태를 분리하세요

​

서브에이전트에 작업 위임

Use separate subagents to inspect the API and its tests in parallel.
Have each report relevant files and findings without editing anything.
Combine their findings into an implementation plan.

---
name: test-reader
description: Inspect tests and report coverage gaps without editing files.
tools: Read, Grep, Glob
---
Find tests relevant to the requested change. Summarize coverage gaps and
cite the test files. Do not modify files.

​

도구를 효율적으로 사용하기

• 반복적으로 사용하는 의존성을 이미지에 설치하세요. 생성 시 준비된 container_image를 전달하면 세션마다 동일한 테스트 도구와 런타임을 설치하지 않아도 됩니다. 샌드박스 설정을 참조하세요.
• 작업에 필요한 도구를 선택하세요. 하니스에서 스킬과 Model Context Protocol(MCP) 서버를 설정하세요. cws-agent로 관리하는 CLI 세션에서는 로컬 설정을 미리 보고 선택한 항목을 해당 샌드박스로 임포트하세요:
  cws-agent config preview [SANDBOX-NAME] --verbose
  cws-agent config sync [SANDBOX-NAME]
  
  Claude Managed Agents 워커에서는 설정 임포트를 사용할 수 없습니다. sync 명령어는 항목 선택과 확인을 요청합니다. 변경 사항을 불러오려면 에이전트를 다시 시작하세요. 필요한 실행 파일을 샌드박스에 설치하고 노트북 컴퓨터에서만 유효한 경로를 바꾸세요. 스킬 및 MCP 임포트를 참조하세요.
• 핵심 결과를 반환하세요. 도구가 데이터를 모델에 반환하기 전에 샌드박스에서 필터링하거나 요약하도록 하세요. 예를 들어 전체 테스트 출력을 파일에 저장하고 실패한 테스트 이름과 간략한 실패 요약을 반환하세요. 후속 검토를 위해 파일을 계속 사용할 수 있도록 유지하세요.
• 독립적인 오퍼레이션을 병렬로 실행하세요. 리소스가 허용하는 경우 독립적인 검사를 동시에 실행하세요. 의존성이 있는 단계는 사전 요구 사항이 충족될 때까지 기다리세요. SDK 실행 가이드에서 명령어를 시작하고 결과를 수집하는 방법을 설명합니다.

​

결과 보존 및 컴퓨팅 중지