Làm cách nào để sử dụng API Claude 2?

API Claude 2 là phiên bản phát hành mới nhất từ Anthropic, cung cấp cho các nhà phát triển quyền truy cập đàm thoại nâng cao với khả năng của Claude. Trong hướng dẫn toàn diện này, chúng tôi sẽ đề cập đến mọi thứ bạn cần biết để bắt đầu tích hợp Claude 2 vào ứng dụng của mình.

Giới thiệu về Claude 2

Được phát hành vào tháng 11 năm 2023, Claude 2 thể hiện một bước tiến lớn trong lĩnh vực AI đàm thoại. Được xây dựng trên công nghệ AI Hiến pháp của Anthropic để đảm bảo an toàn và đạo đức, Claude 2 có khả năng hiểu ngôn ngữ ấn tượng trong khi vẫn duy trì các API đơn giản và trực quan.

Một số cải tiến chính trong Claude 2 bao gồm:

• Đối thoại tự nhiên hơn – Claude 2 hiểu sâu hơn về ngữ cảnh và tính liên tục, cho phép luồng đối thoại giống người hơn.
• Kiến thức rộng – Claude 2 đã đọc nhiều sách giáo khoa và tập dữ liệu, vì vậy nó có thể thảo luận chi tiết về nhiều chủ đề.
• Theo dõi trạng thái – Claude 2 duy trì theo dõi trạng thái nội bộ, vì vậy nó có thể tham chiếu một cách nhất quán những điều được đề cập trước đó trong cuộc trò chuyện.
• An toàn ngay từ thiết kế – Claude 2 được phát triển với các phương pháp AI Hiến pháp tự giám sát của Anthropic, tập trung vào sự an toàn.

Các điểm cuối mà Claude 2 cung cấp giúp việc truy cập các khả năng đàm thoại mạnh mẽ này trở nên đơn giản. Chỉ với vài dòng mã trong bất kỳ ngôn ngữ lập trình nào, bạn có thể tích hợp khả năng trả lời câu hỏi, đối thoại, phân loại văn bản, v.v.

Bây giờ, chúng ta hãy đi sâu vào các chi tiết kỹ thuật khi làm việc với API Claude 2!

Xác thực

Giống như bất kỳ API nào, bước đầu tiên là thiết lập xác thực để truy cập an toàn vào Claude 2. Anthropic sử dụng khóa API để xử lý việc này.

Để nhận khóa API Claude 2 của bạn:

• Đăng ký tài khoản miễn phí tại https://www.anthropic.com
• Từ bảng điều khiển, tạo một ứng dụng mới
• Sao chép khóa API duy nhất được tạo cho ứng dụng đó

Bạn sẽ sử dụng khóa API này cho tất cả các yêu cầu bằng cách đưa nó vào tiêu đề Ủy quyền. Dưới đây là ví dụ yêu cầu cURL có khóa:

Sao chép mã

curl https://api.anthropic.com/v2/hello \ -H ‘Authorization: Bearer <your_api_key>’

Khóa API này phải được giữ kín để tránh lạm dụng hạn ngạch Claude 2 của bạn.

Tổng quan về điểm cuối

API Claude AI 2 bao gồm một số điểm cuối chính cung cấp các chức năng đàm thoại khác nhau:

/v2/conversations – Có một cuộc đối thoại qua lại kéo dài với Claude 2, với nhiều cuộc trao đổi được xây dựng dựa trên lịch sử theo ngữ cảnh.
/v2/classifications – Nhận phân loại của Claude 2 đối với một đoạn văn bản, chẳng hạn như đó là lời nói căm thù, thư rác, v.v.
/v2/completions – Đưa ra lời nhắc và yêu cầu Claude 2 hoàn thành phần còn lại bằng văn bản có liên quan và chu đáo.
/v2/edits – Cung cấp văn bản đầu vào và nhờ Claude 2 viết lại các phần để cải thiện chất lượng.
/v2/answers – Hỏi Claude 2 một câu hỏi và nhận được câu trả lời ngắn gọn.
/v2/search – Truy vấn Claude 2 để tìm đoạn trích văn bản phù hợp nhất từ ​​cơ sở kiến ​​thức của nó về một chủ đề.
/v2/embeddings – Nhận các phần nhúng vectơ cho văn bản đầu vào để thực hiện phân tích và so sánh ngữ nghĩa.
Ngoài ra còn có một số điểm cuối tiện ích như /v2/pingkiểm tra tình trạng và /v2/confignhận giới hạn dịch vụ.

Chúng ta sẽ khám phá các mẫu mã cho từng điểm cuối này trong các phần bên dưới.

Khởi tạo ứng dụng khách HTTP

Trước khi gọi bất kỳ điểm cuối nào, chúng tôi cần một ứng dụng khách HTTP bằng ngôn ngữ lập trình đã chọn để gửi yêu cầu và nhận phản hồi.

Đây là mã mẫu để khởi tạo ứng dụng khách bằng Python:

Sao chép mã

python

import requests headers = {“Authorization”: “Bearer YOUR_API_KEY_HERE”} client = requests.Session() client.headers.update(headers)

Và tương tự trong JavaScript/Node.js:

js

Sao chép mã

const { createRequest } = require(‘@anthropic/claude-sdk’); const client = createRequest({ apiKey: ‘YOUR_API_KEY_HERE’, });

Các phần quan trọng là:

Bao gồm khóa API trong tiêu đề ủy quyền
Sử dụng ứng dụng khách HTTP xử lý cookie theo yêu cầu để duy trì trạng thái phiên
Với ứng dụng khách đó đã được định cấu hình, giờ đây chúng tôi có thể gọi bất kỳ API Claude nào bằng cách cung cấp tuyến đường điểm cuối và nhận lại phản hồi.

Điểm cuối cuộc trò chuyện

Điểm cuối của cuộc hội thoại có lẽ là điểm linh hoạt nhất trong tất cả các API của Claude 2. Đúng như tên gọi, nó cho phép đối thoại tự do với nhiều trao đổi.

Hãy xem qua một ví dụ về mã bằng Python khi trò chuyện về du lịch:

Sao chép mã

Python

prompt = “I’m planning a trip to Paris next spring. Any recommendations on where I should visit or what I should be sure to do?” response = client.post(“https://api.anthropic.com/v2/conversations”, json={“messages”:[{“content”: prompt}]}) print(response.json())

Claude bắt đầu cuộc trò chuyện bằng lời đề nghị mở đầu chu đáo:

json

Sao chép mã

{“id”:”c-123456″,”messages”:[{“content”:”In the spring, Paris comes alive with blooming trees, flowers, and extended daylight hours perfect for exploration. When planning your trip, make sure to see some of the iconic landmarks like the Eiffel Tower, Notre Dame Cathedral, and the Louvre Museum. Wandering side streets and cafes, shopping the Champs Elysées, and indulging in pastries gives you a taste of true Parisian culture as well. Let me know if you’d like any specific recommendations for museums, restaurants, neighborhoods or other sights to visit in Paris! What interests you most about the city?”}]}

Bây giờ chúng tôi có thể gửi câu hỏi tiếp theo, nhận câu trả lời dựa trên bối cảnh hiện có:

Python

Sao chép mã

followup = “I’m a big art lover – what museum would you recommend as a must-see?” response = client.post(“https://api.anthropic.com/v2/conversations”, json={“messages”:[{“content”: followup}]}) print(response.json())

Claude nhớ rằng chúng tôi đang lên kế hoạch cho một chuyến đi đến Paris và sở thích của tôi đối với nghệ thuật:

json

Sao chép mã

{“id”:”c-123456″,”messages”:[{“content”:”As an art lover visiting Paris, you absolutely must see the iconic Louvre Museum. With over 380,000 objects and 35,000 works of art, it’s one of the largest museums in the world. From ancient Greek sculptures like the Venus de Milo to Egyptian antiquities and masterpieces like the Mona Lisa, you could easily spend multiple days exploring its vast galleries and collections spanning various wings and historic buildings. Just the building itself with its glass pyramid entrance is a marvel! Make sure to also check out museums like the Musée d’Orsay focused on 19th century works, the Centre Pompidou for its modern/contemporary collections, or if you want something more intimate, the Musée Rodin featuring his iconic works like The Thinker in his former mansion. Let me know if you need any tips for Louvre tickets, tours, hours, etc to plan your perfect art-filled day!”}]}

Chúng ta có thể hỏi Claude 2 bất kỳ câu hỏi tiếp theo nào dựa trên cuộc thảo luận về chuyến du lịch này và Claude sẽ kết hợp ngữ cảnh bổ sung một cách suôn sẻ.

Đó là những điều cơ bản để có một cuộc đối thoại mạch lạc, mở rộng với /conversationsđiểm cuối!

Điểm cuối hoàn thành

Nếu bạn muốn Claude 2 mở rộng một số văn bản ban đầu với các phần tiếp theo có liên quan, chất lượng cao thì điểm cuối hoàn thành là hoàn hảo.

Ví dụ: cung cấp phần mở đầu ghi chú cuộc họp này:

Python

Sao chép mã

prompt = “Meeting notes\nPresent: Bob, Susan and Joan\nAgenda:\n- Employee engagement survey results\n- New health insurance provider” response = client.post(“https://api.anthropic.com/v2/completions”, json={“prompt”: prompt}) print(response.json())

Và Claude hoàn thành ghi chú cuộc họp:

json

Sao chép mã

{“content”:”Meeting notes\nPresent: Bob, Susan and Joan \nAgenda: \n- Employee engagement survey results \n- New health insurance provider\n\nMinutes:\n- Reviewed employee engagement survey results from Q3. Scores have increased 5% since last year across all categories measured. Employees noted career development opportunities and management communication as areas for continued improvement. HR to design new development training programs. \n- Discussed proposals from two new health insurance providers with better coverage at lower premiums. Agreed to proceed with Acme Insurance based on their regional networks and competitive pricing estimates though we will reconfirm exact policy details before open enrollment period. Next actions: finalize policy with Acme, communicate provider change and plan details to employees by 7/1. “}

Phần hoàn thiện xử lý những việc như mở rộng dấu đầu dòng, tiếp tục danh sách, điền vào các mẫu chung và nhiều kiểu tiếp tục bản nháp khác.

Tùy chỉnh nội dung lời nhắc để phù hợp với bất kỳ phần nội dung nào bạn muốn cải thiện và mở rộng.

Điểm cuối câu trả lời

Khi bạn có một câu hỏi cụ thể, hãy sử dụng điểm cuối của câu trả lời để nhận được câu trả lời trực tiếp của Claude.

Ví dụ:

Python

Sao chép mã

question = “What year did the first airplane fly?” response = client.post(“https://api.anthropic.com/v2/answers”, json={“question”: question}) print(response.json())

Trả về một câu trả lời ngắn gọn:

json

Sao chép mã

{“answer”:”The first successful airplane flight was in 1903 by the Wright brothers near Kitty Hawk, North Carolina. On December 17th, 1903 their Flyer airplane took off and flew for 12 seconds over a distance of 120 feet. This milestone achievement is recognized as the beginning of the era of human flight.”}

Bạn có thể hỏi bất cứ điều gì – từ các câu hỏi khoa học đến các câu hỏi lịch sử cho đến các bài toán, v.v. Phản hồi nhằm mục đích trả lời trực tiếp và đầy đủ, không thừa nội dung.

Điểm cuối tìm kiếm

Khi nghiên cứu một chủ đề cụ thể, điểm cuối tìm kiếm của Claude 2 sẽ tìm thấy văn bản trích đoạn phù hợp nhất từ ​​kho kiến ​​thức rộng lớn của nó.

Ví dụ để tìm hiểu về kỹ thuật tưới vườn:

Python

Sao chép mã

query = “text on best practices for watering a vegetable garden” response = client.post(“https://api.anthropic.com/v2/search”, json={“query”: query}) print(response.json())

Có thể trích đoạn văn rất thích hợp này:

json

Sao chép mã

{“text”:”…When watering a vegetable garden, consistency and proper technique are key for healthy plants. Experts recommend daily early morning waterings targeting the roots rather than leaves. About 1 inch of water across the garden area per week is ideal, adjusted for rainfall. Consider drip irrigation hoses or moisturizing mulch to retain moisture. Avoid both over and under-watering which cause damage. Know the unique water needs of each vegetable type you are growing as well…”,”metadata”:{“document”:”Gardening Science Manual: Hydroponics, Irrigation, and Pest Control”}}

Cú pháp tìm kiếm cũng hỗ trợ lựa chọn đoạn văn thông qua các bộ lọc trường như title:hoặc author:cũng như các toán tử logic như ANDhoặc OR.

Duyệt qua nhiều chủ đề theo cách này để khám phá thông tin quan trọng từ kiến ​​thức sâu rộng của Claude 2.

Điểm cuối phân loại

Điểm cuối phân loại áp dụng một trong các mô hình được đào tạo của Claude 2 để nhập văn bản để phân tích.

Ví dụ: đoạn văn bản này:

Sao chép mã

Your receipt from Amazon Store Card & Special Financing on May 24. Why are these always so confusing I didn’t order half this stuff!

Có thể được kiểm tra như vậy:

Python

Sao chép mã

content = “Your receipt from Amazon Store Card & Special Financing on May 24…” response = client.post(“https://api.anthropic.com/v2/classifications”, json={‘model’: ‘impersonation-detection’, ‘content’: content}) print(response.json())

Và Claude 2 trả lời liệu ngôn ngữ có vẻ lừa đảo hay không:

Python

Sao chép mã

{“outcomes”: {“impersonation”: false, “authentic”: true, “unsure”: false}}

Nhiều mô hình khác có sẵn như phát hiện lời nói căm thù, phát hiện thư rác, tóm tắt, v.v. Điều chỉnh modeltham số để tận dụng bất kỳ bộ phân loại nào được đào tạo chuyên nghiệp của Claude 2.

Điểm cuối nhúng

Điểm cuối Claude 2 cuối cùng mà chúng tôi sẽ đề cập đến tạo ra các vectơ nhúng – biểu diễn toán học về ý nghĩa văn bản.

Ví dụ:

Python

Sao chép mã

text = “Claude 2 is the latest conversational AI assistant created by Anthropic.” response = client.post(“https://api.anthropic.com/v2/embeddings”, json={‘content’: text}) print(response.json())

Trả về nhúng vectơ 512 chiều:

Sao chép mã

[0.8412, 0.2511, 0.987, … ]

Những phần nhúng này có thể được so sánh thông qua các số liệu tương tự để xác định các mối quan hệ ngữ nghĩa.

Một số cách sử dụng bao gồm:

Tìm kiếm ngữ nghĩa – lập chỉ mục văn bản bằng cách nhúng để tìm các đoạn liên quan
Đề xuất nội dung – truy xuất nội dung liên quan dựa trên khoảng cách nhúng
Phân tích – phân nhóm các bài viết, ghi điểm cảm tính, xác định các điểm bất thường và hơn thế nữa bằng các nội dung nhúng
Vì vậy, ngoài kết luận, Claude 2 còn cung cấp các biểu diễn ngôn ngữ thô để bạn đánh giá ý nghĩa của văn bản.

Bước tiếp theo

Điều đó kết thúc hướng dẫn của chúng tôi về chức năng cốt lõi có sẵn trong API Claude 2!

Chúng tôi đã thấy việc có được điều đó thật dễ dàng:

Cuộc trò chuyện hấp dẫn với bối cảnh dài hạn được theo dõi
Mở rộng và tiếp tục của bất kỳ văn bản nào
Câu hỏi được trả lời kỹ lưỡng
Tìm kiếm đoạn văn trên một kiến ​​thức sâu rộng
Phân loại văn bản bằng mô hình chuyên gia của Claude
Phân tích nhúng ý nghĩa ngữ nghĩa
Tất cả đều có thể truy cập được chỉ bằng các yêu cầu HTTP bằng ngôn ngữ lập trình yêu thích của bạn.

Một số bước tiếp theo cần cân nhắc với Claude 2:

Xem lại tài liệu chi tiết tại https://www.anthropic.com/docs để tra cứu các tùy chọn và thông số điểm cuối không được đề cập ở đây
Duyệt qua SDK Claude 2 mã nguồn mở (Python, Js/Node, v.v.) với các ví dụ về ứng dụng khách tại https://github.com/anthropic/
Xem xét quy trình đàm thoại nào có thể phù hợp với ứng dụng kinh doanh của bạn
Đăng ký tài khoản miễn phí để nhận khóa API của riêng bạn cho nguyên mẫu tại https://www.anthropic.com
Với khả năng hộp thoại tự học nâng cao được hỗ trợ bởi AI Hiến pháp để đảm bảo an toàn, Claude 2 đại diện cho AI đàm thoại có năng lực và đạo đức nhất hiện nay. Chúng tôi rất vui khi bạn tìm ra những cách sáng tạo để tận dụng tiềm năng của nó!

Nguồn: claudeai.uk