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

Tue, 26 May 2026 00:00:00 +0000

はじめに

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 は具体的に書くほど精度が上がる

次のステップ

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

GitHub Actions で Hugo を自動ビルドする

Tue, 26 May 2026 00:00:00 +0000

概要

GitHub に push するたびに Hugo が自動でビルドされ、Cloudflare Pages にデプロイされる仕組みを構築した。手元でビルドする手間がなくなり、Markdown を書いて push するだけでサイトが更新される。

ワークフローの全体像

main ブランチに push
    ↓
GitHub Actions が起動
    ↓
① Hugo をインストール
② hugo --minify でビルド
③ public/ を Cloudflare Pages にデプロイ
    ↓
サイトが更新される

ワークフローファイル

.github/workflows/deploy.yml に以下を記述する。

name: Build and Deploy

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Hugo
        uses: peaceiris/actions-hugo@v3
        with:
          hugo-version: "latest"

      - name: Build
        run: hugo --minify

      - name: Deploy to Cloudflare Pages
        uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          command: pages deploy public --project-name=my-project

GitHub Secrets の登録

Cloudflare への認証情報を GitHub に登録する。

Genba AI Lab