Chuyển đến nội dung chính
Kết nối là thông tin xác thực đã lưu cho một dịch vụ bên ngoài, chẳng hạn một tài khoản AWS, một cluster Kubernetes hay một tổ chức GitHub. Agent chỉ nhìn thấy và làm được những gì kết nối cho phép, nên trang này hướng dẫn cách thêm, giới hạn phạm vi, kiểm tra và duy trì kết nối. Danh sách đầy đủ các dịch vụ nằm trong danh mục kết nối.

Thêm kết nối

1

Mở Connections

Trên thanh bên, nhấn More → Workspace settings → Connections. Tab Builtin Connections liệt kê mọi dịch vụ được hỗ trợ. Lọc theo danh mục hoặc tìm theo tên. Khi hướng dẫn thiết lập ghi “mở Connections”, đó chính là màn hình này.
Màn hình Connections với danh sách dịch vụ ở bên trái và bảng chi tiết của kết nối đang chọn ở bên phải

Connections: chọn một kết nối để xem discovery, cài đặt, công tắc Allow writes và các agent

2

Mở hướng dẫn thiết lập và làm theo đúng thứ tự

Mở hướng dẫn thiết lập cho dịch vụ của bạn từ danh mục, hoặc nhấn Setup guide trên bảng chi tiết của dịch vụ. Mỗi hướng dẫn liệt kê quyền tối thiểu mà thông tin xác thực cần. Thứ tự thực hiện tùy theo dịch vụ:
3

Kết nối

Chọn dịch vụ và nhấn Connect. Nhập hoặc tải lên thông tin xác thực, rồi nhấn Connect trong hộp thoại.Các dịch vụ hỗ trợ nhiều tài khoản, như AWS, Google Cloud và SSH, còn hỏi Alias (tên ngắn như production) và Description. Agent đọc mô tả để chọn đúng tài khoản, nên hãy viết cụ thể: Production AWS account, us-east-1 workloads.
Dịch vụ chỉ cho phép nhiều kết nối khi bảng chi tiết của nó hiển thị Supports multiple connections. Các dịch vụ khác, như Microsoft Azure, Kubernetes, VMware vCenter và mọi dịch vụ đăng nhập qua OAuth, chỉ cho phép một kết nối mỗi workspace. Để kết nối tenant Azure thứ hai hoặc cluster thứ hai, hãy dùng một workspace riêng.
4

Chờ kiểm tra

CloudThinker kiểm tra kết nối trước khi lưu. Với hầu hết dịch vụ, bước kiểm tra gọi tới dịch vụ bằng thông tin xác thực của bạn. Với một số dịch vụ, như Argo CD, Buildkite, CircleCI, Clarity, Databricks, Notion, Prowler, Render và Rollbar, bước kiểm tra chỉ xác nhận tool của kết nối khởi động được, nên token sai vẫn có thể hiển thị Connected. Với các dịch vụ này, prompt xác minh trong hướng dẫn thiết lập mới là bài kiểm tra thực sự.Trạng thái thành công: dịch vụ hiển thị Connected trong danh sách Connections.
5

Đặt câu hỏi dựa trên kết nối

Mở một cuộc chat và hỏi điều mà chỉ dịch vụ đó trả lời được. Mỗi hướng dẫn thiết lập có một prompt xác minh.
Trạng thái thành công: câu trả lời nêu đúng account ID hoặc project thật của bạn, không phải một lời giải thích chung chung.

Đặt environment

Mỗi kết nối có một Environment: Production, Staging, Development hoặc Not set. Environment là nhãn cho người và agent đọc kết nối. Rules (các điều kiện quyết định thay đổi của agent được chạy, phải chờ người duyệt hay bị từ chối) không đọc nhãn này.
Hộp thoại kết nối không hỏi environment, nên hãy đặt ngay sau khi kết nối. Các dịch vụ chỉ có một kết nối, như Microsoft Azure, và mọi dịch vụ OAuth, như GitHub, Linear và Sentry, không đổi được khỏi Not set. Để xử lý một kết nối khác với kết nối khác, hãy viết một Rule nêu tên kết nối đó.
Trên dịch vụ hỗ trợ nhiều kết nối, mỗi tài khoản là một hàng trong bảng chi tiết của dịch vụ. Để đặt environment, nhấn biểu tượng bút chì trên hàng của tài khoản, rồi cập nhật Environment trong hộp thoại Edit Instance.

Điều gì xảy ra sau khi kết nối

Lần đầu kết nối đạt Connected, CloudThinker chạy Discovery: một cuộc điều tra chạy nền trên dịch vụ bạn vừa kết nối. Kết quả được điền vào phần Discovery trong bảng chi tiết của kết nối. Discovery thường là câu trả lời hữu ích đầu tiên bạn nhận được, nên hãy xem trước khi viết prompt đầu tiên. Discovery tự chạy một lần, tối đa 30 phút. Bạn có thể chạy lại bằng Run Discovery, ví dụ sau khi mở rộng quyền của thông tin xác thực. Bạn cần vai trò Admin của workspace để chạy lại. Discovery tiêu tốn credit, và chi phí tùy thuộc vào lượng dữ liệu dịch vụ đang chứa. Discovery không dùng được credit hằng ngày (100 credit miễn phí mỗi ngày, chỉ dành cho chat trên model Light), nên cần credit trong số dư của workspace. Nếu số dư quá thấp, Discovery tạm dừng kèm thông báo. Hãy nạp thêm credit, rồi nhấn Run Discovery. Discovery dùng cùng các tool và Approvals như một cuộc chat, nhưng không có ai ở đó để trả lời, nên Discovery không bao giờ chờ phê duyệt. Lệnh gọi nào cần hỏi người duyệt sẽ bị bỏ qua, và Discovery tiếp tục với các thao tác đọc còn thực hiện được. Trên Cloudflare và PostHog, nơi mọi lệnh gọi API đều đi qua phê duyệt, trên Databricks và Neon, nơi mọi câu lệnh SQL đều đi qua phê duyệt, và trên Firebase, nơi thao tác chuyển project và kiểm tra trạng thái deploy đi qua phê duyệt, Discovery tìm được ít hơn mỗi khi các lệnh gọi đó cần hỏi người duyệt. Nếu Discovery chạm giới hạn thời gian, kết quả kết thúc ở trạng thái Partial discovery và giữ những gì đã xác minh. Nếu chưa xác minh được gì, kết quả hiển thị Discovery could not finish. Trong cả hai trường hợp, kết nối của bạn vẫn hoạt động.

Cách quyền truy cập hoạt động

Mỗi kết nối thuộc về một workspace. Bất kỳ ai làm việc trong workspace đó, kể cả agent CloudThinker có sẵn và các custom agent của bạn, đều dùng được kết nối mà không cần thiết lập lại. Owner và Admin của tổ chức có vai trò Admin trong mọi workspace. Xem Vai trò workspace.
Trên hầu hết các kết nối có công tắc này, Allow writes bật sẵn. Danh sách gồm AWS, Google Cloud, Azure, Kubernetes, GitHub, GitLab, Bitbucket, Azure DevOps, AWS CodeCommit, Cassandra, Drata, FortiGate, Okta và Rootly. Một vài kết nối tắt sẵn, như Docker Hub, Fly.io, FireHydrant và Snowflake. Argo CD không có công tắc: trường READ_ONLY trong form kết nối mặc định là Full access. Nếu thông tin xác thực bạn kết nối có bất kỳ quyền ghi nào, agent có thể đề xuất thay đổi ngay khi bạn kết nối, và Rules cùng Approval mode của bạn quyết định từng thay đổi. Không có cài đặt cấp workspace hay tổ chức nào để tắt sẵn công tắc này, nên cách kiểm soát là dùng thông tin xác thực chỉ đọc và tắt Allow writes trên từng kết nối. Phần Quyền ghi hoặc Khả năng của agent trong mỗi hướng dẫn thiết lập cho biết kết nối đó bắt đầu ở trạng thái nào.
Hai cơ chế kiểm soát quyết định agent làm được gì với một kết nối:
Các giới hạn lồng nhau: quyền của thông tin xác thực chứa Allow writes, Allow writes chứa Rules và Approval mode; các kết nối kiểu ClickHouse bỏ qua Rules và Approval mode.Các giới hạn lồng nhau: quyền của thông tin xác thực chứa Allow writes, Allow writes chứa Rules và Approval mode; các kết nối kiểu ClickHouse bỏ qua Rules và Approval mode.

Thông tin xác thực là giới hạn trên, Allow writes mở quyền thay đổi, còn Rules và Approval mode quyết định từng thay đổi, trừ các kết nối thuộc loại Connection setting, no approvals.

Cách kiểm soát thao tác ghi tùy thuộc vào kết nối. Phần Khả năng của agent trong mỗi hướng dẫn thiết lập cho biết mô hình nào áp dụng.
Trên kết nối loại Cài đặt kết nối, không phê duyệt như ClickHouse, bật quyền ghi cho phép agent thay đổi dữ liệu mà không có Rule hay phê duyệt nào chặn lại. Hãy dùng database user chỉ đọc, trừ khi bạn thực sự muốn như vậy.
Allow writes bật sẵn với hầu hết kết nối vì thông tin xác thực mới là mức trần: thông tin xác thực chỉ đọc đã chặn mọi thay đổi. Hãy bắt đầu ở chế độ chỉ đọc, và chỉ mở rộng quyền khi bạn có một thay đổi cụ thể muốn agent thực hiện. Kết nối đăng nhập theo một trong hai cách:

Truy cập dịch vụ nội bộ

Kết nối chạy từ CloudThinker Cloud, nên dịch vụ phải nhận được kết nối từ internet. Điều này quan trọng với mọi thứ nằm trong mạng riêng, như vCenter nội bộ, PostgreSQL, Prometheus hay Argo CD.

Xoay vòng thông tin xác thực

Bạn có thể thay thông tin xác thực đã lưu mà không cần ngắt kết nối. Kết nối giữ nguyên alias, cài đặt và lịch sử. Kết nối AWS bằng role dùng thông tin xác thực STS ngắn hạn, nên không có gì cần xoay vòng: External ID vẫn giữ nguyên. Access key, client secret, key JSON và API token thì cần xoay vòng.
1

Tạo thông tin xác thực mới ở phía nhà cung cấp

Tạo key hoặc token mới trước. Giữ key cũ hoạt động cho đến khi hoàn tất việc thay thế.
2

Thay thế trong CloudThinker

Mở dịch vụ trong More → Workspace settings → Connections, nhấn biểu tượng bút chì trên hàng của tài khoản, rồi trong Edit Instance nhấn Replace… cạnh thông tin xác thực đã lưu. Nhập giá trị mới và nhấn Save and test.Trạng thái thành công: bước kiểm tra đạt và kết nối vẫn ở trạng thái Connected. Nếu kiểm tra thất bại, CloudThinker giữ thông tin xác thực cũ và hiển thị lỗi.
3

Thu hồi thông tin xác thực cũ

Xóa hoặc vô hiệu hóa key cũ ở phía nhà cung cấp.
Các dịch vụ chỉ có một kết nối, như Microsoft Azure và Backstage, không có biểu tượng bút chì. Nút Replace credentials của các dịch vụ này chỉ xuất hiện khi kết nối hiển thị Error, nên muốn xoay vòng sớm, hãy ngắt kết nối và kết nối lại bằng giá trị mới. Ngoại lệ là các Git provider dùng token (GitLab, Bitbucket, Azure DevOps và AWS CodeCommit): khi đã thiết lập Review trên các provider này, hãy xoay vòng token trong Review → Settings → Connection actions → Update token, không cần ngắt kết nối. Xem Azure DevOps và Bitbucket. Ngắt rồi kết nối lại sẽ tạo một kết nối mới, nên hãy làm vào lúc ít hoạt động:
  • Agent, automation theo lịch và các lượt làm mới của Optimize không dùng được dịch vụ trong khoảng thời gian giữa lúc ngắt và lúc kết nối lại.
  • Discovery chạy lại và tiêu tốn credit.
  • Allow writes trở về mặc định, tức là bật với hầu hết kết nối. Hãy tắt lại nếu trước đó bạn đã tắt.
  • Kiểm tra các Rules nêu tên kết nối vẫn còn liệt kê kết nối đó.
Hầu hết kết nối OAuth không có thông tin xác thực để thay. Để đổi tài khoản đăng nhập, hãy ngắt kết nối và kết nối lại. Asana là ngoại lệ: Asana lưu Client secret của Asana app, và bạn nhập lại secret mỗi lần kết nối lại.

Khi kết nối bị hỏng

Nếu thông tin xác thực ngừng hoạt động trong lúc chạy nền (token hết hạn, key bị thu hồi, role bị xóa), kết nối chuyển sang Error. Với AWS, cần ba lần thất bại liên tiếp khi chạy nền, nên một trục trặc thoáng qua không làm kết nối chuyển trạng thái. Các kết nối khác chuyển trạng thái khi một lần làm mới token chạy nền hoặc một lượt chạy gặp lỗi xác thực. Admin của workspace nhận một thông báo cho mỗi lần gián đoạn, không phải một thông báo cho mỗi lần thử lại thất bại. Lần kiểm tra do chính bạn chạy không bao giờ gửi thông báo cho ai. Trong lúc kết nối hiển thị Error, các công việc theo lịch phụ thuộc vào kết nối bị bỏ qua, bao gồm các lượt làm mới chi phí của Optimize, automation theo lịch và việc lấy cảnh báo của Pulse. Để khôi phục:
  1. Khắc phục nguyên nhân ở phía nhà cung cấp, ví dụ khôi phục role hoặc cấp key mới.
  2. Mở kết nối. Bảng chi tiết hiển thị lỗi. Nhấn Retry để kiểm tra lại thông tin xác thực đã lưu, hoặc Replace credentials để nhập thông tin mới. Replace credentials mở cùng hộp thoại Edit Instance như Replace…. Với kết nối OAuth, nhấn Connect để đăng nhập lại.
  3. Khi trạng thái trở về Connected, công việc theo lịch tiếp tục ở chu kỳ kế tiếp.

Ngắt kết nối

Mở dịch vụ trong More → Workspace settings → Connections. Trên dịch vụ có các hàng tài khoản, nhấn biểu tượng thùng rác trên hàng của tài khoản. Trên dịch vụ chỉ có một kết nối, nhấn Disconnect trên bảng chi tiết. Xác nhận trong hộp thoại Disconnect. Thao tác này không hoàn tác được. Agent mất quyền truy cập dịch vụ ngay khi ngắt kết nối xong. Sau đó hãy xóa role, key hoặc token ở phía nhà cung cấp, vì ngắt kết nối không xóa chúng ở đó. Nếu bạn kết nối lại dịch vụ, đó là một kết nối mới:
  • Discovery chạy lại và tiêu tốn credit.
  • Allow writes trở về mặc định, và Environment trở về Not set.
  • Rules khớp kết nối theo Alias. Hãy dùng lại đúng Alias khi kết nối lại, để các Rule nêu tên kết nối tiếp tục khớp.

Bảo mật

  • Quyền tối thiểu — chỉ cấp các quyền mà agent cần cho trường hợp sử dụng của bạn; bắt đầu với quyền chỉ đọc và mở rộng sau.
  • Chỉ đọc theo mặc định — sử dụng thông tin xác thực chỉ đọc trừ khi bạn muốn agent thực hiện thay đổi qua kết nối này.
  • Xoay vòng thông tin xác thực — xoay vòng khóa và token theo lịch trình thông thường của bạn; CloudThinker sẽ lấy giá trị mới khi bạn cập nhật kết nối.
  • Thu hồi khi bàn giao — xóa thông tin xác thực tại nhà cung cấp khi bạn xóa một kết nối hoặc khi đồng nghiệp rời nhóm.
Kết nối không tự động ở chế độ chỉ đọc. Nhiều kết nối bắt đầu với Allow writes bật (xem Cách quyền truy cập hoạt động), nên thông tin xác thực chỉ đọc mới là thứ giữ cho kết nối ở chế độ chỉ đọc. Cách CloudThinker xử lý những gì bạn kết nối: Xem Bảo mật để biết chi tiết về mã hóa, thời gian lưu giữ và nhà cung cấp model.

Danh mục kết nối

Cloud

Hạ tầng

Container

Nền tảng ứng dụng

Cơ sở dữ liệu

AI và vector

Giám sát

Log và tìm kiếm

Sự cố

Opsgenie không phải là một kết nối. Hãy gửi cảnh báo của Opsgenie tới Resolve dưới dạng webhook signal từ Resolve → Triggers & Outcomes.

Code và CI/CD

Bảo mật

Tuân thủ

Năng suất

Phân tích

Messaging

Custom MCP

Nếu dịch vụ không có trong danh sách, hãy kết nối dưới dạng kết nối custom MCP. MCP (Model Context Protocol) là một chuẩn mở để cung cấp tool cho AI agent. Các nền tảng chat được thiết lập dưới dạng integration của workspace, không phải kết nối: xem Slack, Microsoft Teams và Google Chat. Kết nối GitHub, GitLab, Bitbucket hoặc Azure DevOps cũng là nền tảng cho Review.

Bước tiếp theo

Kết nối AWS

Tạo IAM role chỉ đọc bằng một script trong CloudShell.

Kết nối Google Cloud

Tạo service account có quyền viewer và tải lên key JSON của nó.

Approvals

Quyết định thay đổi nào agent được tự thực hiện và thay đổi nào cần người duyệt.

Kết nối custom MCP

Kết nối một dịch vụ không có trong danh mục.