Tích hợp kết nối Atoms với các công cụ và dịch vụ bạn đang sử dụng. Tùy thuộc vào connector, Atoms có thể sử dụng thông tin bên ngoài trong khi giúp bạn xây dựng, thêm khả năng cho app đã xuất bản của bạn hoặc hỗ trợ cả hai quy trình làm việc.

Mỗi connector hỗ trợ các hành động và quyền riêng của nó. Hãy xem lại các khả năng và phạm vi quyền được hiển thị cho connector đã kết nối; bảng chi tiết của connector chưa kết nối có thể chỉ hiển thị mô tả và điều khiển kết nối của nó.

Sử dụng tài khoản và phạm vi quyền có đặc quyền tối thiểu nhưng vẫn có thể hoàn thành công việc. Không dán mật khẩu, token truy cập, khóa riêng tư hoặc dữ liệu nhạy cảm không liên quan vào câu lệnh. Khi một dịch vụ chứa dữ liệu sản xuất hoặc dữ liệu khách hàng, hãy kiểm thử bằng một mẫu không nhạy cảm và xác minh chính xác mục tiêu trước khi cho phép ghi.

Các connector và hành động bạn thấy có thể khác nhau tùy theo tài khoản và bản phát hành. Mở danh mục Connector trong Atoms để xem những gì hiện đang khả dụng cho bạn.

Xác định kết nối nên làm gì

Trước khi kết nối một dịch vụ, hãy xác định nơi bạn cần dùng nó.

Mục tiêu	Ví dụ
Cung cấp ngữ cảnh cho Agent trong khi bạn xây dựng	Tìm tệp, tóm tắt tác vụ, xem xét issue hoặc sử dụng dữ liệu dự án trong một câu lệnh
Cho phép Agent thực hiện hành động trong một dịch vụ khác	Tạo một tác vụ, cập nhật một bản ghi, thêm dữ liệu bảng tính hoặc tạo một sự kiện lịch
Thêm một dịch vụ vào app đã xuất bản	Lưu trữ dữ liệu ứng dụng, xử lý xác thực, xử lý thanh toán hoặc chạy một quy trình làm việc của app

Một số connector hỗ trợ nhiều hơn một mục tiêu. Hãy xem lại mô tả connector và các quyền được yêu cầu trước khi bạn kết nối nó.

Kết nối một Tích hợp

Mở Settings → Connectors để sử dụng điểm truy cập chính. Bạn cũng có thể chọn Kết nối công cụ của bạn với Atoms từ bảng điều khiển.

Việc kết nối hoặc ngắt kết nối một Tích hợp có thể yêu cầu quyền truy cập của chủ sở hữu không gian làm việc hoặc quản trị viên được ủy quyền. Nếu bạn không phải là chủ sở hữu hoặc quản trị viên và một điều khiển không khả dụng, hãy hỏi chủ sở hữu không gian làm việc hoặc quản trị viên được ủy quyền.

Từ bảng điều khiển

1. Mở bảng điều khiển Atoms.
2. Chọn Kết nối công cụ của bạn với Atoms.
3. Chọn connector bạn muốn sử dụng. Làm theo điều khiển kết nối được hiển thị trên thẻ connector đó.
4. Sử dụng điều khiển được hiển thị cho connector đó. Nếu nó mở một bảng chi tiết chung, hãy chọn Connect; các Tích hợp dành riêng cho nhà cung cấp có thể mở luồng thiết lập hoặc ủy quyền riêng của chúng.
5. Đăng nhập vào dịch vụ bên ngoài nếu được nhắc.
6. Xem lại tài khoản và quyền, sau đó phê duyệt kết nối.
7. Quay lại Atoms và xác nhận rằng connector hiển thị là đã kết nối. Trong Chat nơi bạn muốn sử dụng nó, mở bộ chọn connector và bật connector cho Chat đó.

Sử dụng một Tích hợp đã kết nối

Hãy cho Agent biết dịch vụ nào cần sử dụng và cung cấp đủ chi tiết để xác định đúng mục. Các chi tiết hữu ích bao gồm:

• Tên dự án, không gian làm việc, kho lưu trữ, thư mục, lịch hoặc bảng tính
• Tên tác vụ, ID issue, tên tệp hoặc mã định danh bản ghi
• Khoảng ngày, ngày đến hạn, người phụ trách, trạng thái hoặc mức độ ưu tiên
• Những gì bạn muốn Atoms đọc, tóm tắt, tạo hoặc cập nhật

Ví dụ:

• “Tóm tắt các issue Linear có mức ưu tiên cao được giao cho tôi.”
• “Tìm bản tóm tắt ra mắt trong Drive và liệt kê các quyết định còn mở.”
• “Thêm các khách hàng tiềm năng đã được phê duyệt này vào bảng tính chiến dịch.”
• “Tạo một sự kiện lịch cho buổi đánh giá thiết kế vào 3 giờ chiều thứ Ba tuần tới.”

Atoms chỉ có thể sử dụng các hành động được connector hỗ trợ và dữ liệu mà tài khoản đã kết nối có thể truy cập. Nếu khả năng hoặc hành động bạn cần không được hiển thị cho connector đó, hãy dừng lại và đừng cho rằng nó được hỗ trợ.

Xem lại các thay đổi bên ngoài trước khi chúng chạy

Khi một connector và hành động hỗ trợ tạo hoặc cập nhật dữ liệu bên ngoài, Atoms có thể hiển thị xác nhận trước khi chạy.

Hãy xem lại:

• Dịch vụ và tài khoản đã kết nối
• Tệp, bảng tính, lịch, dự án hoặc bản ghi mục tiêu
• Thông tin sẽ được tạo hoặc thay đổi
• Mọi ngày, giờ, người nhận hoặc giá trị quan trọng khác

Nếu Atoms hiển thị xác nhận, hãy xem lại và chọn Confirm để tiếp tục hoặc hủy để giữ nguyên dịch vụ bên ngoài. Khả năng ghi phụ thuộc vào connector và hành động; các connector chỉ đọc không cung cấp hành động ghi.

Sau khi ghi, hãy xác minh kết quả trong dịch vụ bên ngoài trước khi thử lại. Nếu mục tiêu hoặc giá trị không đúng, hãy dừng quy trình làm việc và sử dụng lịch sử, hoàn tác hoặc công cụ khôi phục riêng của nhà cung cấp khi có sẵn. Việc ngắt kết nối một connector sẽ dừng việc sử dụng trong tương lai; nó không hoàn tác các thay đổi đã được thực hiện.

Quản lý một kết nối

Mở danh mục Connector và chọn một dịch vụ đã kết nối để xem lại trạng thái hiện tại của nó.

Từ bảng chi tiết connector, bạn có thể:

• Kiểm tra tài khoản nào đang được kết nối
• Xem lại các hành động được connector hỗ trợ và phạm vi quyền
• Kết nối lại khi ủy quyền đã hết hạn
• Làm mới hoặc thay đổi quyền truy cập khi dịch vụ hỗ trợ
• Ngắt kết nối tài khoản khỏi Atoms

Việc ngắt kết nối trong Atoms sẽ dừng việc sử dụng kết nối trong tương lai. Một số dịch vụ cũng có thể yêu cầu bạn thu hồi Atoms khỏi cài đặt tài khoản hoặc bảo mật riêng của dịch vụ đó.

Ví dụ theo trường hợp sử dụng

Bảng dưới đây là cách nhóm nội dung biên tập theo trường hợp sử dụng, không phải là một tập hợp danh mục trong catalog. Hãy sử dụng catalog có thể tìm kiếm để xem danh sách connector hiện có.

Danh mục	Cách dùng phổ biến	Ví dụ
Phát triển	Quản lý mã nguồn, kho lưu trữ, issue và quy trình phân phối	GitHub, Linear
Backend và dữ liệu	Cơ sở dữ liệu, xác thực, lưu trữ và dữ liệu có cấu trúc	Supabase
Thanh toán	Thanh toán khi checkout, lập hóa đơn và quy trình thanh toán	Stripe
Quản lý công việc	Tác vụ, dự án, người phụ trách và ngày đến hạn	Asana, Todoist
Tệp và nội dung	Tìm kiếm, đọc và sắp xếp các tệp bên ngoài	Box, Dropbox
Phân tích và tiếp thị	Lưu lượng truy cập, hiệu suất tìm kiếm, chiến dịch và báo cáo	Google Analytics 4, Google Search Console, Google Ads

Khả năng khả dụng của connector thay đổi theo thời gian. Hãy sử dụng catalog trong Atoms để xem danh sách hiện tại và mở một connector để xem lại chính xác các khả năng của nó.

Hướng dẫn thiết lập

Chọn hướng dẫn cho dịch vụ của bạn:

• Kết nối GitHub
• Kết nối Supabase
• Kết nối GA4
• Kết nối Google Search Console
• Kết nối Google Ads

Đối với các sự cố kết nối, xem Khắc phục sự cố Tích hợp.