MCP - Making a request

[Trần Ngọc]

Making a request

Tạo yêu cầu đầu tiên
Việc tạo yêu cầu đầu tiên đến Anthropic API khá đơn giản khi bạn đã hiểu được cách thiết lập cơ bản và cấu trúc. Hướng dẫn này sẽ hướng dẫn bạn các bước thiết yếu để có Claude phản hồi các lời nhắc của bạn bằng Python.
Thiết lập Môi trường
Trước khi thực hiện bất kỳ lời 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 bảo mật.
Đầu tiên, cài đặt các dependencies cần thiết trong Jupyter notebook của bạn:
%pip install anthropic python-dotenv
Tiếp theo, tạo file .env trong cùng thư mục với notebook để lưu trữ API key một cách bảo mật:
ANTHROPIC_API_KEY="your-api-key-here"
Cách tiếp cận này giữ API key của bạn ra khỏi code và tránh việc vô tình commit nó vào version control. Luôn thêm .env vào file .gitignore của bạn.
Tải các biến môi trường và tạo API client:
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 tạo API request là hàm client.messages.create(). Hàm này yêu cầu ba tham số chính:

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

Tham số max_tokens hoạt động như một cơ chế an toàn. Nếu bạn đặt nó là 1000, Claude sẽ dừng tạo sau 1000 token 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 giới hạ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 chat. Có hai loại messages:

• User messages - Nội dung bạn muốn gửi cho Claude (được viết bởi con người)
• Assistant messages - Các phản hồi mà Claude đã tạo ra

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

Tạo Yêu cầu Đầu tiên
Đây là một ví dụ hoàn chỉnh về việc tạo yêu cầu đến Claude:
message = client.messages.create(
model=model,
max_tokens=1000,
messages=[
{
"role": "user",
"content": "Quantum computing là gì? Trả lời trong một câu"
}
]
)
Khi bạn chạy code này, Claude sẽ xử lý yêu cầu của bạn và trả về một response object chứa văn bản được tạo cùng với metadata về yêu cầu.

Trích xuất Phản hồi
Response object chứa rất nhiều thông tin, nhưng thường bạn chỉ cần văn bản được tạo ra. Truy cập nó bằng:
message.content[0].text
Điều này cho bạn output sạch sẽ, dễ đọc như: "Quantum computing là một loại tính toán tận dụng các nguyên lý cơ học lượng tử như superposition và entanglement để xử lý thông tin bằng quantum bits (qubits), có khả năng giải quyết một số vấn đề phức tạp nhất định nhanh hơn exponentially so với máy tính cổ điển."
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 prompts khác nhau và xây dựng các tương tác phức tạp hơn với Claude.