Anthropic 发布托管 Agent、主动式工作流与能力阶梯曲线——Code with Claude 2026 要点与实践

import anthropic
import os

client = anthropic.Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

# 定义 Agent 可用的工具——这里用文件读写和 git 操作
tools = [
    {
        "name": "read_file",
        "description": "Read the contents of a file in the repository",
        "input_schema": {
            "type": "object",
            "properties": {
                "path": {"type": "string", "description": "Relative file path"}
            },
            "required": ["path"]
        }
    },
    {
        "name": "run_git",
        "description": "Run a git command in the repository sandbox",
        "input_schema": {
            "type": "object",
            "properties": {
                "command": {"type": "string", "description": "Git command, e.g. 'log --oneline -5'"}
            },
            "required": ["command"]
        }
    },
    {
        "name": "write_file",
        "description": "Write or patch a file in the repository",
        "input_schema": {
            "type": "object",
            "properties": {
                "path": {"type": "string"},
                "content": {"type": "string"}
            },
            "required": ["path", "content"]
        }
    }
]

# 提交托管 Agent 任务
# proactive_mode: "interactive" 表示遇到高风险修改时暂停请求确认
response = client.beta.agents.create(
    name="recent-commits-reviewer",
    model="claude-sonnet-4-20250514",  # 按能力阶梯选合适档位
    prompt=(
        "审查本仓库最近 5 个 commit 引入的变更。"
        "对每个 commit：1) 用 run_git 查看diff；2) 用 read_file 读相关源码上下文；"
        "3) 判断是否有 bug、风格问题或遗漏的测试。"
        "如果发现可自动修复的问题，用 write_file 提交修改并说明理由。"
        "如果修改涉及公共 API 或生产配置，暂停并请求确认。"
    ),
    tools=tools,
    proactive_mode="interactive",  # on-demand / proactive / interactive
    timeout_minutes=30,
)

print(f"Agent ID: {response.id}")
print(f"Status: {response.status}")
print(f"查看进度: https://console.anthropic.com/agents/{response.id}")

# 在 GitHub Actions 中，测试失败时调用 Anthropic webhook 触发 Agent
curl -X POST https://api.anthropic.com/v1/beta/agents/webhooks \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "agent_id": "recent-commits-reviewer",
    "trigger": {
      "type": "ci_failure",
      "repo": "my-org/my-project",
      "branch": "main",
      "commit_sha": "$GITHUB_SHA"
    }
  }'