Conversational Analytics API: Tạo tác nhân dữ liệu và trò chuyện với dữ liệu của bạn

Bản xem trước riêng tư

Sản phẩm hoặc tính năng này tuân theo "Điều khoản áp dụng cho các sản phẩm trước giai đoạn phát hành rộng rãi" trong mục Điều khoản chung của dịch vụ trong Điều khoản dành riêng cho dịch vụ. Các sản phẩm và tính năng trước khi phát hành công khai được cung cấp "nguyên trạng" và có thể được hỗ trợ hạn chế. Để biết thêm thông tin, hãy xem phần mô tả giai đoạn ra mắt.

Nhà phát triển có thể sử dụng API Phân tích trò chuyện (truy cập thông qua geminidataanalytics.googleapis.com) để tạo giao diện trò chuyện hoặc tác nhân dữ liệu dựa trên trí tuệ nhân tạo (AI) nhằm trả lời các câu hỏi về dữ liệu có cấu trúc trong BigQuery, Looker và Looker Studio bằng ngôn ngữ tự nhiên. Với API Phân tích trò chuyện, bạn cung cấp cho tác nhân dữ liệu thông tin và dữ liệu doanh nghiệp ("ngữ cảnh"), cũng như quyền truy cập vào các công cụ như SQL, Python và thư viện hình ảnh. Các phản hồi của trợ lý này được trình bày cho người dùng và có thể được ứng dụng khách ghi lại, tạo ra trải nghiệm trò chuyện bằng dữ liệu liền mạch và có thể kiểm tra.

Lưu ý quan trọng: Nếu bạn đang di chuyển từ API Hỏi đáp về dữ liệu, hãy xem hướng dẫn di chuyển để biết thông tin tổng quan về những điểm khác biệt chính và các bước di chuyển bắt buộc.

Tìm hiểu cách thức và thời điểm Gemini cho Google Cloud sử dụng dữ liệu của bạn. Là một công nghệ ở giai đoạn đầu, Gemini cho các sản phẩm Google Cloud có thể tạo ra kết quả có vẻ hợp lý nhưng không chính xác về mặt thực tế. Bạn nên xác thực tất cả đầu ra từ Gemini cho sản phẩm Google Cloud trước khi sử dụng. Để biết thêm thông tin, hãy xem phần Gemini cho Google Cloud và AI có trách nhiệm.

Lưu ý: Các sản phẩm dùng thử trước giai đoạn phát hành rộng rãi (1) chỉ dùng được trong môi trường thử nghiệm và không được dùng trong môi trường sản xuất hoặc để xử lý dữ liệu cá nhân hoặc dữ liệu khác tuân theo các yêu cầu tuân thủ pháp lý hoặc quy định, đồng thời (2) phải tuân thủ Điều khoản về sản phẩm dùng thử trước giai đoạn phát hành rộng rãi trong Điều khoản cụ thể về dịch vụ và Phụ lục về sự đồng ý cho Chương trình Gemini dành cho Google Cloud Người kiểm tra đáng tin cậy.

Bắt đầu sử dụng API Phân tích cuộc trò chuyện

Hãy làm theo các bước sau để thiết lập môi trường, bắt đầu xây dựng và tương tác với các tác nhân dữ liệu bằng cách sử dụng API Phân tích trò chuyện.

Lưu ý: Để sử dụng API Phân tích trò chuyện, bạn phải tham gia bản dùng thử riêng tư. Để bày tỏ sự quan tâm, hãy điền vào biểu mẫu bày tỏ sự quan tâm đến bản xem trước.

Cách thiết lập và điều kiện tiên quyết

Trước khi sử dụng API hoặc các ví dụ, hãy hoàn thành các bước sau:

• Bật API Phân tích cuộc trò chuyện: Mô tả các điều kiện tiên quyết để bật API Phân tích cuộc trò chuyện.
• Xác thực và kết nối với nguồn dữ liệu bằng API Phân tích trò chuyện: Cung cấp hướng dẫn xác thực API và định cấu hình các kết nối với dữ liệu BigQuery, Looker và Looker Studio.

Tạo và tương tác với tác nhân dữ liệu

Sau khi hoàn tất các bước trước, hãy sử dụng API Phân tích trò chuyện để tạo và tương tác với một tác nhân dữ liệu bằng cách làm theo các bước sau:

• Tạo tác nhân dữ liệu bằng HTTP: Cung cấp ví dụ đầy đủ về cách tạo và tương tác với tác nhân dữ liệu bằng cách sử dụng các yêu cầu HTTP trực tiếp với Python.
• Tạo tác nhân dữ liệu bằng SDK Python: Cung cấp ví dụ đầy đủ về cách tạo và tương tác với tác nhân dữ liệu bằng cách sử dụng SDK Python.
• Tạo cuộc trò chuyện nhiều lượt: Cung cấp hướng dẫn và ví dụ về cách xử lý các câu hỏi tiếp theo (cả có trạng thái và không có trạng thái) bằng cách sử dụng SDK Python.
• Hiển thị phản hồi của tác nhân API Phân tích trò chuyện dưới dạng hình ảnh trực quan: Cung cấp ví dụ về cách xử lý thông số kỹ thuật của biểu đồ từ các phản hồi API và hiển thị dưới dạng hình ảnh trực quan bằng cách sử dụng SDK Python và thư viện Vega-Altair.

Các thao tác chính trên API

API này cung cấp các điểm cuối cốt lõi sau đây để quản lý các tác nhân dữ liệu và cuộc trò chuyện:

Tên API	Phương thức HTTP	Thiết bị đầu cuối	Mô tả
Tạo tác nhân	POST	/v1alpha/projects/*/locations/*/dataAgents	Tạo một tác nhân dữ liệu mới.
Tải tác nhân	GET	/v1alpha/projects/*/locations/*/dataAgents/*	Truy xuất thông tin chi tiết về một tác nhân dữ liệu cụ thể.
Cập nhật tác nhân	PATCH	/v1alpha/projects/*/locations/*/dataAgents/*	Sửa đổi một tác nhân dữ liệu hiện có.
Xoá nhân viên hỗ trợ	DELETE	/v1alpha/projects/*/locations/*/dataAgents/*	Xoá một tác nhân dữ liệu.
Liệt kê đại lý	GET	/v1alpha/projects/*/locations/*/dataAgents	Liệt kê các tác nhân dữ liệu có sẵn trong một dự án.
Chat	POST	/v1alpha/projects/*/locations/*:chat	Gửi tin nhắn trò chuyện đến một tác nhân dữ liệu.
Tạo cuộc trò chuyện	POST	/v1alpha/projects/*/locations/*/conversations	Bắt đầu một cuộc trò chuyện mới.
Lấy cuộc trò chuyện	GET	/v1alpha/projects/*/locations/*/conversations/*	Truy xuất thông tin chi tiết về một cuộc trò chuyện cụ thể.
Danh sách cuộc trò chuyện	GET	/v1alpha/projects/*/locations/*/conversations	Liệt kê các cuộc trò chuyện trong một dự án cụ thể.
Danh sách tin nhắn	GET	/v1alpha/projects/*/locations/*/conversations/*/messages	Liệt kê các tin nhắn trong một cuộc trò chuyện cụ thể.

Tài nguyên khác

• Tài liệu tham khảo về API Phân tích trò chuyện: Cung cấp nội dung mô tả chi tiết về các phương thức, điểm cuối và định nghĩa loại cho cấu trúc yêu cầu và phản hồi.