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

Making a request

📖 Nội dung bài học

Tóm tắt

Thực hiện yêu cầu đầu tiên tới Anthropic API khá đơn giản khi bạn hiểu cấu trúc và thiết lập cơ bản. Hướng dẫn này đi qua các bước cần thiết để Claude phản hồi các prompt của bạn bằng Python.

Thiết lập môi trường của bạn

Trước khi thực hiện bất kỳ lệnh gọi API nào, bạn cần cài đặt các gói cần thiết và cấu hình API key một cách an toàn.

Đầu tiên, cài đặt các dependency cần thiết trong Jupyter notebook của bạn:

%pip install anthropic python-dotenv

Tiếp theo, tạo một tệp .env trong cùng thư mục với notebook của bạn để lưu trữ API key một cách an toàn:

ANTHROPIC_API_KEY="your-api-key-here"

Cách tiếp cận này giữ API key của bạn ngoài mã và ngăn chặn việc vô tình commit nó vào hệ thống kiểm soát phiên bản. Luôn thêm .env vào tệp .gitignore của bạn.

Tải các biến môi trường và tạo client API của bạn:

from dotenv import load_dotenv
load_dotenv()

from anthropic import Anthropic

client = Anthropic()
model = "claude-sonnet-4-0"

Hàm Create

Cốt lõi của việc thực hiện các yêu cầu API là hàm client.messages.create(). Hàm này yêu cầu ba tham số chính:

  • model - Tên của model Claude bạn muốn sử dụng
  • max_tokens - Giới hạn an toàn cho độ dài phản hồi (không phải là mục tiêu)
  • messages - Lịch sử cuộc trò chuyện bạn đang gửi tới Claude

Tham số max_tokens hoạt động như một cơ chế an toàn. Nếu bạn đặt nó thành 1000, Claude sẽ dừng tạo sau 1000 tokens ngay cả khi nó còn nhiều điều để nói. Claude không cố gắng đạt đến giới hạn này - nó chỉ viết những gì nó cho là phù hợp và dừng lại nếu đạt đến tối đa.

Hiểu về Messages

Messages đại diện cho cuộc trò chuyện giữa bạn và Claude, tương tự như một ứng dụng trò chuyện. Có hai loại tin nhắn:

  • User messages - Nội dung bạn muốn gửi tới Claude (do con người viết)
  • Assistant messages - Phản hồi mà Claude đã tạo

Mỗi tin nhắn là một dictionary với role (là "user" hoặc "assistant") và content (văn bản thực tế).

Thực hiện yêu cầu đầu tiên của bạn

Đây là một ví dụ hoàn chỉnh về việc thực hiện yêu cầu tới Claude:

message = client.messages.create(
    model=model,
    max_tokens=1000,
    messages=[
        {
            "role": "user",
            "content": "What is quantum computing? Answer in one sentence"
        }
    ]
)

Khi bạn chạy mã này, Claude sẽ xử lý yêu cầu của bạn và trả về một đối tượng phản hồi chứa văn bản được tạo cùng với siêu dữ liệu về yêu cầu.

Trích xuất phản hồi

Đối tượng phản hồi chứa nhiều thông tin, nhưng bạn thường chỉ muốn văn bản được tạo. Truy cập nó bằng cách:

message.content[0].text

Điều này cho bạn kết quả rõ ràng, dễ đọc như: "Quantum computing is a type of computation that leverages quantum mechanics principles like superposition and entanglement to process information using quantum bits (qubits), potentially solving certain complex problems exponentially faster than classical computers."

Với những kiến thức cơ bản này, bạn có thể bắt đầu thử nghiệm với các prompt khác nhau và xây dựng các tương tác phức tạp hơn với Claude.

🔁 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?