Claudeのツールランナーを使ってtool useのループを楽に実装しよう

const messages: Anthropic.MessageParam[] = [
  { role: 'user', content: 'パリの天気を教えて' },
];

let response = await client.messages.create({
  model: 'claude-sonnet-5',
  max_tokens: 1024,
  tools,
  messages,
});

// stop_reasonがtool_useである限り、ツールを実行して結果を返し続ける
while (response.stop_reason === 'tool_use') {
  const toolResults: Anthropic.ToolResultBlockParam[] = [];
  for (const block of response.content) {
    if (block.type !== 'tool_use') continue;
    try {
      // ツール名→実装の振り分けは自前で書く
      const result = await dispatchTool(block.name, block.input);
      toolResults.push({
        type: 'tool_result',
        tool_use_id: block.id,
        content: result,
      });
    } catch (err) {
      toolResults.push({
        type: 'tool_result',
        tool_use_id: block.id,
        content: String(err),
        is_error: true,
      });
    }
  }
  // 会話履歴に応答とツール結果を積んでから、再度呼び出す
  messages.push({ role: 'assistant', content: response.content });
  messages.push({ role: 'user', content: toolResults });
  response = await client.messages.create({
    model: 'claude-sonnet-5',
    max_tokens: 1024,
    tools,
    messages,
  });
}

const finalMessage = await client.beta.messages.toolRunner({
  model: 'claude-sonnet-5',
  max_tokens: 1024,
  max_iterations: 5,
  tools: [getWeatherTool], // run関数付きのツール定義（後述）
  messages: [{ role: 'user', content: 'パリの天気を教えて' }],
});

import { betaZodTool } from '@anthropic-ai/sdk/helpers/beta/zod';
import { z } from 'zod';

const searchFaq = betaZodTool({
  name: 'search_faq',
  description:
    'FAQをキーワードで検索する。回答の根拠づけに必ず使う。ヒットしない場合は言い換え（例: クーポン→割引券）で再検索すること。',
  inputSchema: z.object({
    query: z.string().min(1).describe('検索キーワード（スペース区切りで複数可）'),
  }),
  run: async (input) => {
    // inputは { query: string } に型推論されている
    const hits = scoreSearch([...store.faqs.values()], input.query).slice(0, 5);
    if (hits.length === 0) return '該当するFAQは見つかりませんでした。';
    return JSON.stringify(
      hits.map(({ item }) => ({ id: item.id, title: item.title, body: item.body })),
    );
  },
});

if (hits.length === 0) return '該当するFAQは見つかりませんでした。';

const finalMessage = await client.beta.messages.toolRunner({
  model: config.bedrockModelId,
  max_tokens: 2048,
  max_iterations: 5,
  system: systemPrompt(),
  messages: [...getHistory(lineUserId), { role: 'user', content }],
  tools: buildTools(ctx),
});

const text = finalMessage.content
  .filter((block) => block.type === 'text')
  .map((block) => block.text)
  .join('\n')
  .trim();

import { AnthropicBedrockMantle } from '@anthropic-ai/bedrock-sdk';

const client = new AnthropicBedrockMantle({ awsRegion: 'us-east-1' });

export function buildTools(lineUserId: string) {
  const getMemberProfile = betaZodTool({
    name: 'get_member_profile',
    description:
      'ID連携済み会員の情報（氏名・保有ポイント・失効予定ポイント）を取得する。ポイントや会員情報の質問で必ず使う。',
    inputSchema: z.object({}), // 入力は空。誰の情報かはツール側が知っている
    run: async () => {
      const member = findMemberByLineUserId(ctx.lineUserId); // クロージャ経由で参照
      if (!member) return 'ID連携された会員が見つかりませんでした。';
      return JSON.stringify({
        会員ID: member.id,
        氏名: member.name,
        保有ポイント: member.points,
        失効予定: `${member.expiringPoints.amount}ptが${member.expiringPoints.expiresOn}に失効`,
      });
    },
  });
  // ...他のツールも同様にctxを参照する
  return [getMemberProfile /* , ... */];
}

const finalMessage = await client.beta.messages.toolRunner({
  // ユーザーIDが固定された状態でツール呼び出しできる
  tools: buildTools(ctx.lineUserId),
  // ...
});

const sendContactCard = betaZodTool({
  name: 'send_contact_card',
  description: '電話番号などの問い合わせ先を、コピー用ボタン付きのカードで送る。',
  inputSchema: z.object({
    title: z.string().describe('カードの見出し（例: お客様サービスセンター）'),
    phone: z.string().describe('電話番号（例: 0120-000-000)'),
  }),
  run: async (input) => {
    ctx.extraMessages.push(contactCardFlex(input)); // 副作用: 送信キューに積む
    return 'カードを送信キューに積みました。本文では番号を繰り返さず簡潔に案内してください。';
  },
});

const runner = client.beta.messages.toolRunner({
  model: 'claude-sonnet-5',
  max_tokens: 1024,
  max_iterations: 5,
  tools: buildTools(ctx),
  messages: [{ role: 'user', content: 'いま何ポイント持ってる？あと直近の注文いつ届く？' }],
});

let turn = 0;
for await (const message of runner) {
  turn += 1;
  console.log(`--- ターン${turn} (stop_reason: ${message.stop_reason}) ---`);
  for (const block of message.content) {
    if (block.type === 'tool_use') {
      console.log(`[tool_use] ${block.name} ${JSON.stringify(block.input)}`);
    }
    if (block.type === 'text') {
      console.log(`[text] ${block.text}`);
    }
  }
}

--- ターン1 (stop_reason: tool_use) ---
[tool_use] get_member_profile {}
[tool_use] get_orders {}
--- ターン2 (stop_reason: end_turn) ---
[text] 山田様、ご確認しました。

【保有ポイント】
現在 **1,250pt** お持ちです。
※このうち500ptは2026-08-31に失効予定ですので、お早めのご利用がおすすめです。

【直近の注文】
一番新しいご注文は以下の2件が「配送準備中」です。

- **ORD-1034**（2026-08-10注文／珪藻土バスマット Lサイズ×2、防カビ剤お風呂用×1）
  → 配送予定日：**2026-08-16**
- **ORD-1031**（2026-08-08注文／ガーデンテーブル3点セット×1）
  → 配送予定日：**2026-08-15**

（参考：ORD-1023「電動ドライバー MKD-350」は2026-08-03に配達済みです）

配送日の変更などご希望があれば教えてください。