Anthropic API

Đăng Ký Và Lấy API Key

Tạo tài khoản trên Anthropic Console và lấy API key để bắt đầu tích hợp.

Đăng ký tại console.anthropic.com, vào mục API Keys, tạo key mới và lưu vào biến môi trường `ANTHROPIC_API_KEY`.

Nạp một khoản nhỏ vào Billing trước để tránh gián đoạn khi test request đầu tiên.

Gọi Thử Request Cơ Bản

Cài SDK chính thức và gửi thử một request chat đơn giản để xác nhận kết nối hoạt động.

Chạy `pip install anthropic`, gọi `client.messages.create(model="claude-sonnet-4-5", max_tokens=1024, messages=[{"role":"user","content":"..."}])`.

Luôn set `max_tokens` phù hợp với nhu cầu thực tế để tránh phát sinh chi phí không cần thiết.

Viết System Prompt Định Hướng Vai Trò Agent

Thiết lập system prompt mô tả rõ vai trò, giới hạn và giọng văn của agent hỗ trợ khách hàng.

Truyền tham số `system` mô tả: 'Bạn là trợ lý hỗ trợ kỹ thuật của công ty X, chỉ trả lời dựa trên tài liệu được cung cấp, luôn lịch sự và ngắn gọn.'

Nêu rõ trong system prompt việc agent phải từ chối trả lời nếu không tìm thấy thông tin, tránh bịa đặt câu trả lời.

Kết Nối Tool Tra Cứu Tài Liệu Qua Tool Use

Định nghĩa tool tra cứu tài liệu nội bộ để Claude có thể chủ động gọi khi cần thêm thông tin.

Truyền tham số `tools` mô tả schema hàm `search_docs(query)`, xử lý khi response trả về `tool_use` bằng cách chạy hàm thật và gửi lại kết quả.

Giới hạn số lượng kết quả tool trả về (ví dụ top 3 đoạn tài liệu) để tránh làm loãng ngữ cảnh.

Bật Prompt Caching Và Theo Dõi Chi Phí

Kích hoạt cache cho phần system prompt và tài liệu cố định để giảm chi phí cho các request lặp lại.

Đánh dấu `cache_control: {"type": "ephemeral"}` cho khối nội dung tài liệu ít thay đổi trong request, theo dõi usage trên Console.

Prompt caching hiệu quả nhất khi phần nội dung được cache giống hệt nhau giữa nhiều request liên tiếp.