Bắt đầu sử dụng API Perspective

Bắt đầu sử dụng API Perspective

Thông tin về lớp học lập trình này

Lần cập nhật gần đây nhất: thg 3 10, 2022

Tác giả: Jigsaw

1. Trước khi bắt đầu

API Perspective là một API miễn phí giúp bạn tổ chức các cuộc trò chuyện tốt hơn trên mạng. API này sử dụng công nghệ máy học (ML) để phân tích một chuỗi văn bản và dự đoán tác động nhận thức được của chuỗi văn bản đó lên một cuộc trò chuyện.

Trong lớp học lập trình này, bạn thiết lập API góc nhìn.

Lưu ý: API góc nhìn giúp cho việc kiểm duyệt nội dung dễ dàng hơn. Điều này không có nghĩa là sẽ thay thế hoàn toàn công việc của những người ra quyết định.

Kiến thức bạn sẽ học được

• Phương pháp kiểm duyệt sử dụng trí tuệ nhân tạo giúp gắn cờ nội dung ngay từ lúc tạo nội dung đó.

Bạn cần có

• Tài khoản Google để truy cập vào Google Cloud
• Tốc độ Internet ổn

2. Bắt đầu

Để bắt đầu, bạn cần có một dự án trên Google Cloud để xác thực các yêu cầu API của mình.

1. Trong Google Cloud Console, hãy dùng một dự án hiện có.
2. Nếu cần, hãy làm theo các bước sau để tạo một dự án mới:

• Đăng nhập bằng Tài khoản Google.
• Mở Cloud Console.
• Nhấp vào Tạo dự án hoặc mở trình đơn Chọn dự án rồi nhấp vào Dự án mới trong hộp thoại.
• Đặt tên cho dự án của bạn, rồi nhấp vào Tạo.

Dự án hiện đã xuất hiện trong trình đơn thả xuống.

Yêu cầu quyền truy cập API

• Để yêu cầu quyền truy cập API, hãy hoàn tất biểu mẫu này.

Trong vòng một giờ, bạn sẽ nhận được email xác nhận rằng bạn có thể xem và bật API trong Google Cloud.

Lưu ý: Nếu bạn không nhận được email trong vòng 1 ngày làm việc, hãy hoàn tất biểu mẫu một lần nữa hoặc liên hệ với nhóm hỗ trợ.

3. Bật API

• Trong Cloud Console, hãy chuyển đến trang Tổng quan về API phối cảnh rồi nhấp vào Bật.

4. Tạo khoá API

1. Trong trình đơn điều hướng, hãy nhấp vào API & Dịch vụ > Thông tin xác thực > Tạo thông tin xác thực > Khóa API.

Lưu ý: Nếu bạn đưa ra yêu cầu từ ngôn ngữ phía máy khách như JavaScript, khóa API của bạn sẽ hiển thị với tất cả khách truy cập. Bạn nên ủy quyền yêu cầu qua máy chủ và áp dụng các hạn chế đối với khóa để khóa được ẩn khỏi trình duyệt và chỉ máy chủ của bạn mới có thể sử dụng khóa đó. Để biết thêm thông tin, hãy xem ví dụ về cách ủy quyền yêu cầu thông qua máy chủ và các đề xuất bảo mật khóa API khác.

Khóa API của bạn sẽ hoạt động sau vài phút, nhưng cũng có thể mất đến một giờ. Cho đến lúc đó, bạn có thể nhận được thông báo lỗi.

2. Sao chép khóa API.

5. Yêu cầu mẫu

Bạn có thể tạo thư viện ứng dụng API bằng Thư viện ứng dụng API của Google. Những ví dụ này cho bạn biết cách thiết lập thư viện API bằng một số ngôn ngữ phổ biến nhất.

1. Thực hiện một yêu cầu AnalyzeComment.
2. Chạy một trong các lệnh gọi API mẫu này để nhận điểm trực tiếp từ API Perspective.

Phương thức AnalyzeComment đưa ra yêu cầu API để phân tích trường comment.text cho requestedAttributes (trong trường hợp này là mô hình TOXICITY).

3. Dán khoá API của bạn vào trường API_KEY.

Nếu muốn, bạn có thể tận dụng cờ doNotStore để đảm bảo tất cả các bình luận đã gửi sẽ tự động bị xóa sau khi điểm được trả về.

4. Hãy đọc Tài liệu tham khảo về API để biết thông tin chi tiết về tất cả các trường yêu cầu và phản hồi, cũng như các giá trị có sẵn cho requestedAttributes.

Bạn cũng có thể sử dụng các thuộc tính thử nghiệm như OBSCENE, ATTACK_ON_mypage và SPAM.

Python

Yêu cầu mẫu và phản hồi mẫu này sử dụng phiên bản Python của Thư viện ứng dụng API của Google.

1. Cài đặt thư viện ứng dụng Python.
2. Chạy các lệnh sau:

Bạn sẽ thấy nội dung như sau:

Lời chào thân thiện của bạn nhận được điểm độc hại thấp.

Nút.js

Yêu cầu và phản hồi mẫu này sử dụng phiên bản Node.js của Thư viện ứng dụng API của Google.

1. Cài đặt thư viện ứng dụng Node.js hoặc cài đặt gói npm googleapis.
2. Chạy các lệnh sau:

Bạn sẽ thấy nội dung như sau:

cURL

Yêu cầu mẫu và phản hồi này sử dụng lệnh cURL. Lệnh này sẽ hoạt động với hầu hết người dùng MacOS và Linux. Bạn có thể phải cài đặt cURL để chạy lệnh này.

• Thay thế YOUR_KEY_HERE bằng khóa API của bạn.

Trong phản hồi này, trường attributeScores.TOXICITY.summaryScore.value đưa ra điểm số của bình luận độc hại đối với mô hình. Nhận xét nhận được điểm 0,9 trên 1.0.

6. Xin chúc mừng

Bạn đã thiết lập và chạy API góc nhìn!

Tìm hiểu thêm

• Trang web của Perspective API chứa thêm thông tin về API, bao gồm cả các nghiên cứu điển hình.
• Trang web dành cho nhà phát triển API Perspective chứa nhiều thông tin hơn về các thuộc tính, ngôn ngữ và phương thức. Nếu bạn muốn bắt đầu nhanh, trang Phương thức sẽ mô tả cách sử dụng phương thức AnalyzeComment và SuggestCommentScore.