도구 결과 보내기

// 도구 결과 되먹이기 — Claude가 tool_use 블록으로 도구 실행을 요청하면,
// 우리 서버에서 함수를 돌리고 그 결과를 tool_result 블록에 담아 되돌려준다.
// tool_result 는 role:user 메시지 안에 들어가며, tool_use_id 로
// "어떤 요청에 대한 답인지"를 짝짓는다 — 순서가 아니라 ID로 매칭한다.

// 도구 함수 — 로컬에서 실제로 실행된다.
function calculator(input) {
  return input.a + input.b;
}
const TOOLS = { calculator: calculator };

// Claude가 돌려준 assistant 메시지. content 는 블록의 배열이고,
// 텍스트 블록 뒤에 tool_use 블록이 온다. 여러 개일 수 있다.
// ── 여기서부터 직접 고쳐 보세요 ──
// 숫자를 바꾸거나 tool_use 블록을 더 넣어 보세요. id 하나를 일부러 틀리게
// 두면(예: "PO9" → "XXX") 아래 매칭에서 어떻게 잡히는지 볼 수 있습니다.
const assistantContent = [
  { type: "text", text: "두 계산을 도구로 처리하겠습니다." },
  { type: "tool_use", id: "AB3", name: "calculator", input: { a: 10, b: 10 } },
  { type: "tool_use", id: "PO9", name: "calculator", input: { a: 30, b: 30 } },
];

// 4단계 — 각 tool_use 블록의 input 을 함수에 넘겨 실제로 실행한다.
// 5단계 — 결과를 tool_result 블록으로 만든다. tool_use_id 는 원래 블록의 id.
function runTools(content) {
  return content
    .filter(function (b) { return b.type === "tool_use"; })
    .map(function (block) {
      const fn = TOOLS[block.name];
      let result, isError = false;
      try {
        if (!fn) throw new Error("알 수 없는 도구: " + block.name);
        result = String(fn(block.input));       // content 는 보통 JSON 문자열로
      } catch (e) {
        result = e.message; isError = true;      // 실패 시 is_error: true
      }
      return { type: "tool_result", tool_use_id: block.id, content: result, is_error: isError };
    });
}

const toolResults = runTools(assistantContent);

// 후속 요청에 보낼 user 메시지 — tool_result 블록들을 담는다.
const followupUserMessage = { role: "user", content: toolResults };

console.log("── 실행 결과 (tool_result 블록) ──");
toolResults.forEach(function (r) {
  console.log("  tool_use_id " + r.tool_use_id + " → " + r.content +
    (r.is_error ? "  (is_error: true)" : ""));
});

// ID 매칭 vs 순서 매칭 — 결과 순서를 뒤집어도 ID로는 정확히 짝지어진다.
console.log("");
console.log("── ID로 짝짓기 (결과 순서를 뒤집어도 정확) ──");
const shuffled = toolResults.slice().reverse();
assistantContent
  .filter(function (b) { return b.type === "tool_use"; })
  .forEach(function (use) {
    const byId = shuffled.find(function (r) { return r.tool_use_id === use.id; });
    const byOrderIdx = assistantContent
      .filter(function (b) { return b.type === "tool_use"; })
      .indexOf(use);
    const byOrder = shuffled[byOrderIdx];
    console.log("  요청 " + use.id + " (" + use.input.a + "+" + use.input.b + ")");
    console.log("    · ID 매칭   → " + (byId ? byId.content : "짝을 찾지 못함(id 불일치)"));
    console.log("    · 순서 매칭  → " + byOrder.content +
      (byOrder.tool_use_id !== use.id ? "  ← 엉뚱한 결과에 붙음" : ""));
  });

console.log("");
console.log("── Claude에 다시 보낼 대화 기록 ──");
console.log("  1. user      — 원래 질문");
console.log("  2. assistant — 텍스트 + tool_use 블록 " +
  assistantContent.filter(function (b) { return b.type === "tool_use"; }).length + "개");
console.log("  3. user      — tool_result 블록 " + followupUserMessage.content.length + "개");
console.log("후속 요청에도 원래 도구 스키마(tools)를 반드시 함께 보냅니다 — 블록들이 그 도구를 가리키기 때문입니다.");