서버 도구와 computer use는 실행하는 쪽이 달라

직접 만든 도구와 실행 주체가 달라

Anthropic은 web_search, code_execution 같은 서버 도구를 제공해. 커스텀 도구처럼 tools에 넣지만 실행은 애플리케이션이 아니라 Anthropic 쪽에서 처리해. computer_use도 요청에선 똑같아 보이지만 클라이언트 쪽 도구야. 스키마는 Anthropic이 정하고 모델도 그걸 배웠지만, 스크린샷을 찍고 클릭을 실제로 하는 건 네 코드야. 검색 연결이나 Python 격리 환경을 처음부터 만들지 않고도 능력을 붙일 수 있어.

검색과 코드 실행은 추측을 줄여

web_search는 모델의 학습 시점 뒤 정보를 가져오고, code_execution은 산수와 데이터 처리를 실제 Python으로 계산하게 해. 둘 다 별도 비용과 호출 한도, 요청당 검색 수나 샌드박스 자원 같은 설정이 있으니 가격과 제한을 확인해야 해.

computer_use는 훨씬 넓은 권한을 가져

computer_use에서 모델은 마우스와 키보드 동작을 요청하고, 네 하네스가 네가 통제하는 기계에서 그걸 실행한 뒤 스크린샷을 돌려보내. 그렇게 가상 데스크톱을 조작해. 오래된 GUI 입력, 일반 자동화가 막히는 브라우징, 접근성 시험에 쓸 수 있지만 잘못된 클릭의 피해 범위도 커. 격리 환경과 허용 목록, 사람의 승인을 함께 두는 강력한 도구야.

원칙: Anthropic이 안정적으로 제공하는 실행 능력은 활용하되, 비용과 권한 경계까지 함께 받아들여.

Code

web_search·code_execution 추가·python

resp = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=2048,
    tools=[
        {
            "type": "web_search_20250305",
            "name": "web_search",
            "max_uses": 5,
        },
        {
            "type": "code_execution_20250522",
            "name": "code_execution",
        },
        # ... 너 커스텀 도구도 함께
    ],
    messages=[{"role": "user", "content": "What was the closing S&P 500 yesterday? Show the calculation in Python."}],
)

computer_use sketch (Python)·python

# computer_use는 네 기계에서 돌아. 여기는 요청 모양뿐이고, 도구 버전은
# 모델과 맞아야 해(최신 computer use 문서에서 짝을 확인해).
resp = client.beta.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=4096,
    tools=[
        {
            "type": "computer_20241022",
            "name": "computer",
            "display_width_px": 1280,
            "display_height_px": 720,
        }
    ],
    betas=["computer-use-2024-10-22"],
    messages=[{"role": "user", "content": "Open Firefox and go to anthropic.com"}],
)
# 각 tool_use 블록이 좌표 기반 액션; tool_result로 스크린샷 stream back.

Exercise

사용자 정의 도구 하나를 알맞은 서버 도구로 바꿔 봐. Google API 포장은 web_search로, Python 계산 다리는 code_execution으로 대체하고 신뢰성과 비용을 비교해.

Hint

서버 도구가 더 안정적일 수 있지만 실제 호출량의 가격은 공식 가격표로 계산해.

직접 만든 도구와 실행 주체가 달라

검색과 코드 실행은 추측을 줄여

computer_use는 훨씬 넓은 권한을 가져

Code

External links

Exercise

Progress

댓글 0