API tóm tắt GenAI Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Các khả năng chính

GenAI Summarization API có các chức năng sau:

• Tóm tắt văn bản, được phân loại là bài viết hoặc cuộc trò chuyện.
• Tóm tắt kết quả trong một, hai hoặc ba dấu đầu dòng.

Bắt đầu

Lưu ý: API này yêu cầu Android API cấp 26 trở lên.

Thêm API tóm tắt của ML Kit làm phần phụ thuộc trong cấu hình build.gradle.

implementation("com.google.mlkit:genai-summarization:1.0.0-beta1")

Tiếp theo, hãy triển khai mã trong dự án của bạn:

1. Tạo một đối tượng Summarizer.
2. Tải tính năng xuống nếu có thể tải xuống.
3. Tạo yêu cầu tóm tắt.
4. Chạy suy luận và truy xuất kết quả.

Cách mô hình xử lý nhiều loại dữ liệu đầu vào

Khi đầu vào văn bản được chỉ định là InputType.CONVERSATION, mô hình sẽ mong đợi đầu vào ở định dạng sau:

<name>: <message> <name2>: <message2> <name>: <message3> <name3>: <message4>

Điều này giúp mô hình tạo ra bản tóm tắt chính xác hơn bằng cách cung cấp thông tin chi tiết hơn về cuộc trò chuyện và các lượt tương tác.

Các tính năng được hỗ trợ và giới hạn

Câu lệnh phải có dưới 4.000 mã thông báo (hoặc khoảng 3.000 từ tiếng Anh). Nếu đầu vào vượt quá 4.000 mã thông báo, hãy cân nhắc các lựa chọn sau:

• Ưu tiên việc tóm tắt 4.000 mã thông báo đầu tiên. Thử nghiệm cho thấy điều này thường mang lại kết quả tốt cho các câu hỏi dài. Hãy cân nhắc bật tính năng tự động rút gọn bằng cách gọi setLongInputAutoTruncationEnabled để hệ thống tự động rút gọn dữ liệu đầu vào bổ sung.
• Phân đoạn đầu vào thành các nhóm gồm 4.000 mã thông báo và tóm tắt từng nhóm.
• Hãy cân nhắc một giải pháp trên đám mây phù hợp hơn với dữ liệu đầu vào lớn hơn.

Đối với InputType.ARTICLE, nội dung đầu vào cũng phải có hơn 400 ký tự, trong đó mô hình hoạt động hiệu quả nhất khi bài viết có ít nhất 300 từ.

GenAI Summarization API hỗ trợ tiếng Anh, tiếng Nhật và tiếng Hàn, đồng thời được xác định trong SummarizerOptions.Language.

Khả năng sử dụng cấu hình tính năng cụ thể (do SummarizerOptions chỉ định) có thể thay đổi tuỳ thuộc vào cấu hình của thiết bị cụ thể và các mô hình đã được tải xuống thiết bị.

Cách đáng tin cậy nhất để nhà phát triển đảm bảo rằng tính năng API dự kiến được hỗ trợ trên một thiết bị có SummarizerOptions được yêu cầu là gọi phương thức checkFeatureStatus(). Phương thức này cung cấp trạng thái xác định về khả năng sử dụng tính năng trên thiết bị trong thời gian chạy.

Lưu ý: Sự khác biệt về phần cứng giữa các loại thiết bị có thể dẫn đến sự khác biệt về phiên bản mô hình cơ sở Gemini Nano và do đó, sự khác biệt về đầu ra của API GenAI của Bộ công cụ học máy. Bộ chuyển đổi LoRA được áp dụng để giảm thiểu sự khác biệt.

Các vấn đề thường gặp về chế độ thiết lập

Lưu ý: API này không được hỗ trợ trên các thiết bị có trình tải khởi động chưa khoá.

Các API GenAI của Bộ công cụ học máy dựa vào ứng dụng Android AICore để truy cập vào Gemini Nano. Khi thiết bị vừa được thiết lập (bao gồm cả thiết lập lại) hoặc ứng dụng AICore vừa được thiết lập lại (ví dụ: xoá dữ liệu, gỡ cài đặt rồi cài đặt lại), ứng dụng AICore có thể không có đủ thời gian để hoàn tất quá trình khởi động (bao gồm cả việc tải các cấu hình mới nhất xuống từ máy chủ). Do đó, các API AI tạo sinh của Bộ công cụ học máy có thể không hoạt động như mong đợi. Sau đây là các thông báo lỗi thiết lập thường gặp mà bạn có thể gặp phải và cách xử lý các lỗi đó:

Ví dụ về thông báo lỗi Cách xử lý AICore không hoạt động được do lỗi loại 4-CONNECTION_ERROR và mã lỗi 601-BINDING_FAILURE: Không liên kết được dịch vụ AICore. Điều này có thể xảy ra khi bạn cài đặt ứng dụng bằng các API GenAI của Bộ công cụ học máy ngay sau khi thiết lập thiết bị hoặc khi AICore bị gỡ cài đặt sau khi ứng dụng của bạn được cài đặt. Việc cập nhật ứng dụng AICore rồi cài đặt lại ứng dụng của bạn sẽ khắc phục được vấn đề này. AICore không hoạt động được do lỗi loại 3 - PREPARATION_ERROR và mã lỗi 606 - FEATURE_NOT_FOUND: Không có tính năng .... Điều này có thể xảy ra khi AICore chưa tải xong các cấu hình mới nhất. Khi thiết bị kết nối với Internet, quá trình cập nhật thường mất từ vài phút đến vài giờ. Việc khởi động lại thiết bị có thể giúp quá trình cập nhật diễn ra nhanh hơn. Xin lưu ý rằng nếu trình tải khởi động của thiết bị bị mở khoá, bạn cũng sẽ thấy lỗi này. API này không hỗ trợ các thiết bị có trình tải khởi động đã mở khoá. AICore gặp lỗi loại 1 - DOWNLOAD_ERROR và mã lỗi 0 - UNKNOWN: Tính năng ... gặp lỗi với trạng thái lỗi 0 và esz lỗi: UNAVAILABLE: Không thể phân giải máy chủ ... Giữ kết nối mạng, chờ vài phút rồi thử lại. Lưu ý: Mặc dù việc đặt lại nhiều lần là điều thường thấy đối với nhà phát triển, nhưng người dùng ít khi làm như vậy. Ngoài ra, tất cả các trường hợp thiết lập không thành công này đều có thể được phát hiện bằng API checkFeatureStatus() hoặc checkStatus(). Hãy nhớ gọi checkFeatureStatus() hoặc checkStatus() trước khi hiện bất kỳ giao diện người dùng nào có liên quan, để người dùng ứng dụng của bạn không gặp phải những lỗi này trong mọi trường hợp.

Mã mẫu

• Các mẫu GenAI của Bộ công cụ học máy