Claude API ではじめるAIエージェント開発

Anthropic の Claude API を使ってシンプルなAIエージェントを実装する方法をまとめた。

はじめに

Claude API を使うと、数十行のコードでAIエージェントの基本動作を実装できる。このページでは、Python を使ったシンプルな実装例をまとめる。

必要なもの

  • Python 3.10 以上
  • Anthropic API キー
  • anthropic パッケージ
pip install anthropic

最小構成のエージェント

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "製造現場でAIが役立つ場面を3つ挙げてください。"}
    ]
)

print(response.content[0].text)

ツール呼び出し（Tool Use）

エージェントに「道具」を持たせることで、外部システムと連携できる。

tools = [
    {
        "name": "get_machine_status",
        "description": "設備の稼働状態を取得する",
        "input_schema": {
            "type": "object",
            "properties": {
                "machine_id": {
                    "type": "string",
                    "description": "設備ID"
                }
            },
            "required": ["machine_id"]
        }
    }
]

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    tools=tools,
    messages=[
        {"role": "user", "content": "設備A-01の状態を確認してください。"}
    ]
)

ポイント

  • API キーは環境変数（ANTHROPIC_API_KEY）で管理する
  • max_tokens は用途に応じて調整する
  • ツールの description は具体的に書くほど精度が上がる

次のステップ

  • 複数ターンの会話管理
  • エラーハンドリング
  • ログ・モニタリングの実装