Bỏ qua đến nội dung chính

Thực thi mã và Files API

📖 Nội dung bài học

Lùi←

Chú thích Bật/Tắtc

Toàn màn hình/Thoát toàn màn hìnhf

Tắt tiếng/Bật tiếngm

Giảm kích thước chú thích-

Tăng kích thước chú thích+ hoặc =

Chuyển %0-9 Gia đình phông chữ

Tóm tắt

Claude API cung cấp hai tính năng mạnh mẽ kết hợp rất tốt với nhau: Files API và Thực thi mã. Mặc dù ban đầu có vẻ riêng biệt, nhưng việc kết hợp chúng sẽ mở ra một số khả năng rất thú vị để ủy thác các tác vụ phức tạp cho Claude.

Files API

Files API cung cấp một cách thay thế để xử lý việc tải lên tệp. Thay vì mã hóa hình ảnh hoặc PDF trực tiếp trong tin nhắn của bạn dưới dạng dữ liệu base64, bạn có thể tải tệp lên trước và tham chiếu chúng sau này.

Cách hoạt động như sau:

  • Tải tệp của bạn lên (hình ảnh, PDF, văn bản, v.v.) lên Claude bằng một lệnh gọi API riêng
  • Nhận một đối tượng siêu dữ liệu tệp chứa ID tệp duy nhất
  • Tham chiếu ID tệp đó trong các tin nhắn trong tương lai thay vì bao gồm dữ liệu tệp thô

Cách tiếp cận này đặc biệt hữu ích khi bạn muốn tham chiếu cùng một tệp nhiều lần hoặc khi làm việc với các tệp lớn hơn, việc đưa vào trong mỗi yêu cầu sẽ rất bất tiện.

Công cụ Thực thi mã

Thực thi mã là một công cụ dựa trên máy chủ, không yêu cầu bạn cung cấp một triển khai. Bạn chỉ cần bao gồm một lược đồ công cụ được xác định trước trong yêu cầu của mình và Claude có thể tùy chọn thực thi mã Python trong một container Docker bị cô lập.

Các đặc điểm chính của môi trường thực thi mã:

  • Chạy trong một container Docker bị cô lập
  • Không có quyền truy cập mạng (không thể gọi API bên ngoài)
  • Claude có thể thực thi mã nhiều lần trong một cuộc trò chuyện duy nhất
  • Kết quả được Claude ghi lại và diễn giải để đưa ra phản hồi cuối cùng

Kết hợp Files API và Thực thi mã

Sức mạnh thực sự đến từ việc sử dụng các tính năng này cùng nhau. Vì các container Docker không có quyền truy cập mạng, Files API trở thành cách chính để đưa dữ liệu vào và ra khỏi môi trường thực thi.

Đây là một quy trình làm việc điển hình:

  1. Tải tệp dữ liệu của bạn lên (chẳng hạn như CSV) bằng Files API
  2. Bao gồm một khối tải lên container trong tin nhắn của bạn với ID tệp
  3. Yêu cầu Claude phân tích dữ liệu
  4. Claude viết và thực thi mã để xử lý tệp của bạn
  5. Claude có thể tạo đầu ra (chẳng hạn như biểu đồ) mà bạn có thể tải xuống

1. Upload file qua Files API

2. container_upload block với file_id

3. Yêu cầu Claude phân tích

4. Claude viết + chạy code trong Docker isolated

5. Generate output — biểu đồ, kết quả file

Ví dụ thực tế

Hãy xem một ví dụ thực tế bằng cách sử dụng dữ liệu dịch vụ phát trực tuyến. Tệp CSV chứa thông tin người dùng bao gồm các cấp độ đăng ký, thói quen xem và liệu họ đã hủy (hủy đăng ký) hay chưa.

Đầu tiên, tải tệp lên bằng một hàm trợ giúp:

file_metadata = upload('streaming.csv')

Sau đó, tạo một tin nhắn bao gồm cả tệp đã tải lên và yêu cầu phân tích:

messages = []
add_user_message(
    messages,
    [
        {
            "type": "text",
            "text": """Chạy phân tích chi tiết để xác định các yếu tố chính thúc đẩy việc hủy đăng ký.
            Đầu ra cuối cùng của bạn phải bao gồm ít nhất một biểu đồ chi tiết tóm tắt các phát hiện của bạn."""
        },
        {"type": "container_upload", "file_id": file_metadata.id},
    ],
)

chat(
    messages,
    tools=[{"type": "code_execution_20250522", "name": "code_execution"}]
)

Tìm hiểu về phản hồi

Khi Claude dùng thực thi mã, phản hồi chứa nhiều loại khối:

  • Khối văn bản - Phân tích và giải thích của Claude
  • Khối sử dụng công cụ máy chủ - Mã thực tế mà Claude quyết định chạy
  • Khối kết quả công cụ thực thi mã - Đầu ra từ việc chạy mã

Claude có thể thực thi mã nhiều lần trong một phản hồi duy nhất, xây dựng phân tích của nó một cách lặp đi lặp lại. Mỗi chu kỳ thực thi bao gồm mã và kết quả của nó.

Tải xuống các tệp đã tạo

Một trong những tính năng mạnh mẽ nhất là khả năng Claude tạo tệp (chẳng hạn như biểu đồ hoặc báo cáo) và cho phép tải xuống. Khi Claude tạo một hình ảnh trực quan, nó sẽ được lưu trữ trong container và bạn có thể tải xuống bằng Files API.

Tìm các khối có type: "code_execution_output" trong phản hồi - chúng chứa ID tệp cho nội dung đã tạo:

download_file("file_id_from_response")

Kết quả là một phân tích toàn diện với các hình ảnh trực quan chuyên nghiệp, việc tạo ra chúng theo cách thủ công sẽ đòi hỏi rất nhiều mã hóa.

Vượt ra ngoài Phân tích dữ liệu

Mặc dù phân tích dữ liệu là một sự phù hợp tự nhiên, nhưng sự kết hợp giữa Files API và thực thi mã sẽ mở ra nhiều khả năng:

  • Xử lý và thao tác hình ảnh
  • Phân tích cú pháp và chuyển đổi tài liệu
  • Tính toán và mô hình hóa toán học
  • Tạo báo cáo với định dạng tùy chỉnh

Điểm mấu chốt là bạn có thể ủy thác các tác vụ tính toán phức tạp cho Claude trong khi vẫn duy trì quyền kiểm soát đối với đầu vào và đầu ra thông qua Files API. Điều này tạo ra một quy trình làm việc mạnh mẽ, trong đó Claude trở thành trợ lý viết mã của bạn, người thực sự có thể thực thi và lặp lại các giải pháp.

Tải xuống

🔁 Bài học liên quan

📚 Nguồn & ghi nhận

Bài học có hữu ích không?

Góp ý / Báo lỗiPhát hiện sai sót hoặc có ý tưởng cải thiện?