AIエージェント開発ガイド——Claude APIで最初の一体を作る

bun add @anthropic-ai/sdk

# .dev.vars（ローカル開発用・gitignore対象）
ANTHROPIC_API_KEY=sk-ant-xxxx

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });

const response = await client.messages.create({
  model: 'claude-sonnet-5',
  max_tokens: 1024,
  system: 'あなたは業務効率化を支援するアシスタントです。簡潔に回答してください。',
  messages: [{ role: 'user', content: '在庫管理システムを作る際の注意点を3つ教えて' }],
});

console.log(response.content);

const tools = [
  {
    name: 'search_inventory',
    description: '商品名またはSKUで在庫データベースを検索し、在庫数と保管場所を返す',
    input_schema: {
      type: 'object',
      properties: {
        query: { type: 'string', description: '検索したい商品名またはSKU' },
      },
      required: ['query'],
    },
  },
];

async function searchInventory(query: string) {
  // 実際には社内DBへのクエリに置き換える
  return { query, stock: 42, location: 'A-3棚' };
}

async function runAgent(userMessage: string) {
  const messages: Anthropic.MessageParam[] = [{ role: 'user', content: userMessage }];

  while (true) {
    const response = await client.messages.create({
      model: 'claude-sonnet-5',
      max_tokens: 1024,
      system: 'あなたは在庫管理を支援するアシスタントです。必要に応じてsearch_inventoryツールを使ってください。',
      tools,
      messages,
    });

    messages.push({ role: 'assistant', content: response.content });

    if (response.stop_reason !== 'tool_use') {
      // ツール呼び出しが不要 = 最終回答が出た
      return response.content;
    }

    // ツール呼び出しブロックを取り出して実行する
    const toolResults = [];
    for (const block of response.content) {
      if (block.type === 'tool_use' && block.name === 'search_inventory') {
        const result = await searchInventory(block.input.query as string);
        toolResults.push({
          type: 'tool_result' as const,
          tool_use_id: block.id,
          content: JSON.stringify(result),
        });
      }
    }

    messages.push({ role: 'user', content: toolResults });
    // ループの先頭に戻り、ツール結果を踏まえた次の判断をモデルに求める
  }
}