Vòng lặp Tool-Call khứ hồi
Tool calling là một điệu nhảy gồm hai lượt. Bạn gửi tin nhắn của người dùng cùng với các tool schemas của bạn; mô hình trả lời bằng một khối tool_use nói rằng "call get_weather with {city: 'Paris'}"; mã của bạn chạy hàm đó và gửi câu trả lời lại dưới dạng một tool_result; sau đó mô hình sử dụng nó để viết phản hồi cuối cùng. Bài học này xây dựng bước ở giữa -> phần mà yêu cầu của mô hình trở thành một lệnh gọi Python thực sự và kết quả được đóng gói để gửi ngược lại.
Đây là vòng lặp thực tế (chỉ mang tính minh họa -> chúng ta không gọi mạng):
resp = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
tools=TOOLS, messages=history)
# resp.stop_reason == "tool_use". The model may ask for SEVERAL tools at once:
# append its turn once, run every tool_use block, and send ALL the results
# back together in ONE user message.
history.append({"role": "assistant", "content": resp.content})
results = []
for block in resp.content:
if block.type == "tool_use":
result = TOOLS_BY_NAME[block.name](**block.input)
results.append({"type": "tool_result", "tool_use_id": block.id,
"content": str(result)})
history.append({"role": "user", "content": results})
final = client.messages.create(model="claude-opus-5-5", max_tokens=1024,
tools=TOOLS, messages=history)Các chi tiết bắt buộc: bạn gọi hàm mà mô hình đặt tên với các đối số nó đưa ra, bạn echo lại tool_use_id của nó vào trong tool_result để mô hình có thể khớp mỗi câu trả lời với yêu cầu của nó, và khi một lượt yêu cầu nhiều công cụ bạn trả về mọi kết quả trong một tin nhắn người dùng duy nhất (việc chia chúng ra nhiều tin nhắn sẽ dạy mô hình dừng yêu cầu song song). Trong bài học này bạn xử lý trường hợp đơn giản nhất, một lần gọi công cụ; bài học 4 xử lý nhiều công cụ. Chúng ta mô hình hóa phản hồi dưới dạng một dict thuần túy để nó chạy offline:
{"content": [{"type": "tool_use", "id": "toolu_1",
"name": "get_weather", "input": {"city": "Paris"}}],
"stop_reason": "tool_use"}Bạn đang xây dựng run_tool_call(resp, tools), nơi tools ánh xạ tên công cụ tới một Python function. Nó phải:
- Tìm khối đầu tiên trong
resp["content"]cótypelà"tool_use". - Tra cứu
tools[name]và gọi nó vớiinputcủa khối làm keyword arguments:tools[name](**block["input"]). Nếu tên không có trongtools, hãy raise (mộtKeyErrorhoặcValueError) -> không bao giờ chạy một công cụ mà mô hình tự bịa ra. - Trả về tin nhắn tiếp theo của người dùng để gửi kết quả lại:
{"role": "user",
"content": [{"type": "tool_result",
"tool_use_id": <the block's id>,
"content": str(result)}]}Chuyển kết quả thành chuỗi với str(result) -> nội dung tool_result được truyền dưới dạng văn bản. Xây dựng sao cho hai lần gọi công cụ khác nhau (khác tên và đầu vào) tạo ra hai thông báo tool_result khác nhau, tool_use_id gốc được phản hồi lại, và một tên công cụ không xác định sẽ gây lỗi.
Viết run_tool_call(resp, tools). Tìm khối {"type": "tool_use", "id", "name", "input"} đầu tiên trong resp["content"], gọi tools[name](**input), và trả về thông báo tiếp theo {"role": "user", "content": [{"type": "tool_result", "tool_use_id": <id>, "content": str(result)}]}. Báo lỗi nếu tên công cụ không nằm trong tools.
Bạn thấy vấn đề gì trong bài học này? Hãy báo cáo nó · Hỏi về bài học này
Bài tập này sẽ sớm mở.
Hoàn thành bài học trước đó để mở khóa bài này. Toàn bộ khóa học là miễn phí, không cần tài khoản, và bạn có thể đọc bài học này ngay bây giờ.
Trình duyệt này đang chặn cookie cho learn.floati.life, nên các bài học bạn đã hoàn thành tại đây không thể mở theo thứ tự. Hãy cho phép cookie cho trang web này và tải lại trang.