Claude API 400 “tool_use ids were found without tool_result blocks” — quy tắc thứ tự

Bất biến được nêu một lần

Mỗi block tool_use trong một lượt assistant cần đúng một block tool_result trong thông báo user ngay sau đó, mang cùng tool_use_id. Nhiều block tool_use trong một lượt cần nhiều block tool_result trong cùng thông báo kế tiếp đó. Không được có gì nằm giữa hai lượt.

Luôn trả lời, kể cả khi công cụ thất bại

Mô hình xử lý công cụ thất bại hoàn toàn tốt; điều nó không thể xử lý là công cụ bị thiếu. Trả lỗi dưới dạng tool_result giữ cho cuộc trò chuyện hợp lệ và thường giúp khôi phục hợp lý thay vì nhận lỗi 400.

results = []
for block in (b for b in resp.content if b.type == "tool_use"):
    try:
        out = run_tool(block.name, block.input)
        results.append({
            "type": "tool_result",
            "tool_use_id": block.id,
            "content": str(out),
        })
    except Exception as e:
        # A failed tool still owes the model an answer.
        results.append({
            "type": "tool_result",
            "tool_use_id": block.id,
            "content": f"Tool failed: {e}",
            "is_error": True,
        })

messages.append({"role": "assistant", "content": resp.content})
messages.append({"role": "user", "content": results})

Xác thực hai lượt cuối trước khi gửi

Khoảng một chục dòng assertion có thể phát hiện lỗi này tại nơi gọi thay vì nhận lỗi 400 từ mạng — duyệt các tool_use id của lượt assistant và xác nhận lượt user kế tiếp trả lời tất cả chúng.

def check_pairs(messages):
    for i, m in enumerate(messages):
        if m["role"] != "assistant" or not isinstance(m.get("content"), list):
            continue
        ids = {b.get("id") for b in m["content"]
               if isinstance(b, dict) and b.get("type") == "tool_use"}
        if not ids:
            continue
        nxt = messages[i + 1] if i + 1 < len(messages) else None
        answered = {b.get("tool_use_id") for b in (nxt or {}).get("content", [])
                    if isinstance(b, dict) and b.get("type") == "tool_result"}
        missing = ids - answered
        assert not missing, f"message {i}: unanswered tool_use {missing}"

Cắt lịch sử tại ranh giới khứ hồi

Việc cắt cửa sổ ngữ cảnh theo số lượng thông báo cuối cùng sẽ sớm cắt giữa tool_use và tool_result. Hãy coi cặp này là một đơn vị không thể chia tách khi quyết định nội dung cần loại bỏ.

Tôi có thể bỏ lượt tool_use thay vì trả lời không?

Có, nếu bạn bỏ toàn bộ lượt assistant. Điều không hợp lệ là giữ tool_use nhưng bỏ tool_result.

Endpoint tương thích OpenAI có cùng quy tắc không?

Vẫn cần ghép cặp tương tự, nhưng tên khác — tool_calls trên thông báo assistant, sau đó là một thông báo role: "tool" cho mỗi lệnh gọi, mang tool_call_id.

Yêu cầu bị từ chối có mất phí không?

Trên Kunavo thì không. Các yêu cầu thất bại được ghi nhận với chi phí bằng 0 và không bao giờ dẫn đến một lệnh gọi thượng nguồn bị tính phí.