GASでClaude APIのTool useを使い
AIにGAS関数を実行させる方法

// AIに使わせる「道具」を定義する
// name / description / input_schema の3点セット
const TOOLS = [
  {
    name: "search_customer",
    description:
      "顧客マスタシートから会社名で顧客を検索し、担当者名と電話番号を返す。" +
      "顧客の連絡先を聞かれたときに使う。",
    input_schema: {
      type: "object",
      properties: {
        company: {
          type: "string",
          description: "検索する会社名（部分一致）",
        },
      },
      required: ["company"],
    },
  },
  {
    name: "create_event",
    description:
      "Googleカレンダーに予定を登録する。日時が確定した打ち合わせを登録したいときに使う。",
    input_schema: {
      type: "object",
      properties: {
        title: { type: "string", description: "予定のタイトル" },
        startAt: {
          type: "string",
          description: "開始日時（例: 2026-07-20T14:00:00+09:00）",
        },
        minutes: { type: "number", description: "所要時間（分）" },
      },
      required: ["title", "startAt", "minutes"],
    },
  },
];

// ツールの実体。呼ぶのはAIではなく、このGASコード
function runTool(name, input) {
  switch (name) {
    case "search_customer":
      return searchCustomer(input.company);
    case "create_event":
      return createEvent(input.title, input.startAt, input.minutes);
    default:
      throw new Error("未知のツール: " + name);
  }
}

function searchCustomer(company) {
  const sheet = SpreadsheetApp.getActive().getSheetByName("顧客マスタ");
  const rows = sheet.getDataRange().getValues();
  const hits = rows
    .slice(1) // 見出し行を除く
    .filter((row) => String(row[0]).indexOf(company) !== -1)
    .map((row) => ({ company: row[0], person: row[1], tel: row[2] }));

  if (hits.length === 0) {
    return "該当する顧客は見つかりませんでした。";
  }
  return JSON.stringify(hits);
}

function createEvent(title, startAt, minutes) {
  const start = new Date(startAt);
  if (isNaN(start.getTime())) {
    throw new Error("startAt の日時形式が不正です: " + startAt);
  }
  const end = new Date(start.getTime() + minutes * 60 * 1000);
  const event = CalendarApp.getDefaultCalendar().createEvent(title, start, end);
  return "登録しました。イベントID: " + event.getId();
}

// Claude APIを1回呼ぶ。tools を渡すのがポイント
const API_URL = "https://api.anthropic.com/v1/messages";
const MODEL = "claude-opus-4-8";

function callClaude(messages) {
  const apiKey = PropertiesService.getScriptProperties()
    .getProperty("ANTHROPIC_API_KEY");

  const payload = {
    model: MODEL,
    max_tokens: 2048,
    system:
      "あなたは社内アシスタントです。顧客情報や予定登録が必要なときは、" +
      "推測で答えず必ず用意されたツールを使ってください。",
    tools: TOOLS,
    messages: messages,
  };

  const res = UrlFetchApp.fetch(API_URL, {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": apiKey,
      "anthropic-version": "2023-06-01",
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
  });

  const code = res.getResponseCode();
  if (code !== 200) {
    throw new Error("Claude API エラー(" + code + "): " + res.getContentText());
  }
  return JSON.parse(res.getContentText());
}

// tools を渡したときのレスポンス例（抜粋）
{
  "id": "msg_01...",
  "stop_reason": "tool_use",        // ← ツールを呼びたいという合図
  "content": [
    { "type": "text", "text": "顧客マスタを確認します。" },
    {
      "type": "tool_use",
      "id": "toolu_01AbCd...",       // ← tool_result で返すときに使うID
      "name": "search_customer",
      "input": { "company": "山田商事" }
    }
  ]
}

// 往復ループ本体。stop_reason が "tool_use" の間だけ回す
const MAX_TURNS = 5; // GASの6分制限を意識して必ず上限を決める

function askAssistant(userText) {
  const messages = [{ role: "user", content: userText }];

  for (let turn = 0; turn < MAX_TURNS; turn++) {
    const res = callClaude(messages);

    // ツール要求がなければ、それが最終回答
    if (res.stop_reason !== "tool_use") {
      return res.content
        .filter((block) => block.type === "text")
        .map((block) => block.text)
        .join("");
    }

    // AIの発言をそのまま履歴に積む（tool_useブロックごと必要）
    messages.push({ role: "assistant", content: res.content });

    // 呼ばれたツールをすべて実行し、結果を1つのuserメッセージにまとめる
    const results = res.content
      .filter((block) => block.type === "tool_use")
      .map((block) => {
        try {
          return {
            type: "tool_result",
            tool_use_id: block.id,
            content: String(runTool(block.name, block.input)),
          };
        } catch (e) {
          return {
            type: "tool_result",
            tool_use_id: block.id,
            content: "エラー: " + e.message,
            is_error: true,
          };
        }
      });

    messages.push({ role: "user", content: results });
  }

  return "ツールの往復が上限に達しました。質問を分けて試してください。";
}

// 使い方：カスタムメニューから呼ぶ例
function onOpen() {
  SpreadsheetApp.getUi()
    .createMenu("AIアシスタント")
    .addItem("質問する", "showPrompt")
    .addToUi();
}

function showPrompt() {
  const ui = SpreadsheetApp.getUi();
  const res = ui.prompt("AIに質問", "例: 山田商事の担当者は？", ui.ButtonSet.OK_CANCEL);
  if (res.getSelectedButton() !== ui.Button.OK) return;

  const answer = askAssistant(res.getResponseText());
  ui.alert(answer);
}

// 実行例
// 質問: 「山田商事の担当者を教えて」
//   → AIが search_customer({company:"山田商事"}) を要求
//   → GASがシートを検索して結果を返す
//   → AIが「担当は佐藤様、電話は03-xxxx-xxxxです」と回答