자체 호스팅 워커 참조

이 페이지는 self_hosted 환경을 처리하는 사전 빌드된 워커를 설명합니다. 작업 중심 가이드는 자체 호스팅 샌드박스와 자체 호스팅 워커 배포부터 시작하세요.

CLI 명령 및 플래그

환경 변수

호스트 요구 사항

메모리 스토어에는 자체 요구 사항이 추가됩니다.

샌드박스 파일 시스템

자체 호스팅 환경에서는 세션의 시스템 프롬프트에 Anthropic 관리형 샌드박스에서 사용되는 /mnt/session/outputs 지침이 포함되지 않습니다. 최종 결과물은 에이전트가 샌드박스 파일 시스템에 기록하는 위치에 저장되며, 일반적으로 작업 디렉터리 아래에 있습니다.

스킬에는 에이전트가 직접 실행할 수 있는 실행 파일이 포함될 수 있습니다. CLI 및 SDK 워커는 스킬 번들을 추출할 때 번들에 기록된 실행 권한을 유지합니다. 스킬 다운로드를 수동으로 구현하는 경우 실행 권한 설정은 사용자의 책임입니다.

SDK 헬퍼

Python, TypeScript 및 Go SDK는 서로 다른 제어 수준의 세 가지 헬퍼를 제공합니다:

EnvironmentWorker

EnvironmentWorker는 AgentToolContext와 도구 세트를 자동으로 관리합니다. 도구 목록을 사용자 지정하려면 tools 팩토리를 전달하세요:

EnvironmentWorker(client, ..., tools=lambda env: [beta_bash_tool(env), my_custom_tool])

작업 폴러

전체 예제는 SDK 폴러에서 샌드박스 시작을 참조하세요.

세션 도구 러너

client.beta.sessions.events.tool_runner()는 도구 목록을 tools로 받습니다. 해당 목록을 만들려면 AgentToolContext를 직접 설정하고 beta_agent_toolset_20260401(env)를 호출하세요:

from anthropic.lib.tools.agent_toolset import (
    AgentToolContext,
    beta_agent_toolset_20260401,
)

async with AgentToolContext(
    workdir="/workspace", client=client, session_id=work.data.id
) as env:
    # /workspace/skills/<name>/에 다운로드된 스킬
    tools = beta_agent_toolset_20260401(env)

AgentToolContext 및 에이전트 도구 세트

AgentToolContext는 도구 호출을 위한 실행 컨텍스트입니다. 작업 디렉터리와 경로 정책을 정의하며, 세션의 스킬을 다운로드할 수 있습니다.

EnvironmentWorker는 세션의 메모리 스토어 디렉터리를 allowed_roots에 직접 추가하고, access: "read_only"로 연결된 스토어의 디렉터리를 read_only_roots에 추가합니다.

이 제한은 파일 도구에만 적용되는 보호 장치이며 샌드박스가 아닙니다. bash는 제한하지 않습니다.

beta_agent_toolset_20260401(env)는 AgentToolContext를 받아 표준 도구 구현(bash, read, write, edit, glob, grep)을 반환합니다.