Chương 5

Kênh và trình kết nối

Một tác nhân chỉ hữu ích ngang với những nơi nó có thể vươn tới. Chương này nói về bốn kiểu kết nối: kênh nhắn tin, tài khoản đã kết nối, máy chủ MCP và webhook.

Tất cả các chương

Bốn kiểu kết nối

  • Kênh nhắn tin - cách mọi người liên hệ được với tác nhân. Được cấu hình riêng theo từng tác nhân, trong Trình kết nối tab.
  • Tài khoản đã kết nối - cách tác nhân tiếp cận các công cụ kinh doanh của bạn. Được cấu hình cho toàn bản triển khai hoặc riêng theo từng tác nhân, trong Kết nối mục.
  • máy chủ MCP - các công cụ bổ sung do một dịch vụ bên ngoài công bố, được thêm vào tab MCP tab.
  • Webhook - các sự kiện máy-với-máy theo cả hai chiều, trong tab Webhook tab.

Kênh nhắn tin

Olano nói được hơn 15 kênh nhắn tin. Bộ chọn trình kết nối cung cấp những kênh đã xác minh - Telegram, WhatsApp, Discord, Slack, Signal, SMS qua Twilio, DingTalk, Feishu/Lark, WeCom, Weixin, QQ Bot và DeBox - và mỗi kênh được thêm vào qua một biểu mẫu có hướng dẫn, định kiểu rõ ràng, kèm hướng dẫn thiết lập bên cạnh. Bạn không bao giờ phải chỉnh sửa cấu hình thô để thêm một kênh.

  1. Mở tác nhân, rồi vào tab Connectors, rồi bấm Add. Chọn nền tảng. Biểu mẫu hiện ra chỉ hỏi những gì nền tảng đó cần, và mọi trường đều kèm gợi ý giải thích nó làm gì, định dạng được chấp nhận, và điều gì xảy ra nếu bạn để trống.
  2. Cung cấp thông tin đăng nhập. Telegram cần một token bot từ @BotFather; Slack cần một token bot và một token ứng dụng; Discord cần một ứng dụng bot. Trường đó được gắn nhãn đúng tên thông tin đăng nhập và lưu giá trị vào kho đã mã hóa của bạn, chứ không lưu trong cấu hình của tác nhân.
  3. Ghép nối, ở nơi ghép nối là cơ chế hoạt động. WhatsApp liên kết bằng mã QR từ nút Pair / Connect trong biểu mẫu. Signal có một trình hướng dẫn từng bước - đăng ký số, giải captcha, xác minh mã, đặt tên hồ sơ. WeChat hiện một mã QR để bạn quét và xác nhận, rồi gắn tài khoản đã quét vào tác nhân đó.
  4. Quyết định ai được phép nói chuyện với nó. Hầu hết trình kết nối đều có danh sách cho phép. Trên Telegram, WhatsApp, DeBox và DingTalk, đây là một cổng chặn cứng: người gửi có trong danh sách thì vào được, người khác thì không. Trên Slack, email, SMS, Matrix và Mattermost, cùng một trường đó lại đánh dấu người dùng đáng tin cậy thay vì chặn - nó cấp quyền chủ sở hữu mà không chặn bất kỳ ai khác.
  5. Lưu và khởi động lại tác nhân. Thông tin đăng nhập của kênh được đọc khi tác nhân khởi động, nên một token mới hoặc đã đổi cần khởi động lại mới có hiệu lực.

Mỗi dòng trình kết nối hiển thị tình trạng và chẩn đoán, đồng thời che các giá trị trông giống bí mật. Bên dưới dòng đó, một ghi chú cho bạn biết thông tin đăng nhập nào thực sự đang được dùng: đặt riêng cho tác nhân này, dùng một giá trị dùng chung, hay hoàn toàn chưa được đặt.

Lưu ý

Hai tác nhân dùng chung một token bot nghĩa là chỉ một trong hai sẽ nhận được tin nhắn - nền tảng chỉ gửi mỗi tin nhắn một lần. Hãy cho mỗi tác nhân bot riêng và token riêng của nó. Bảng điều khiển sẽ cảnh báo bạn khi phát hiện xung đột.

Lưu ý

Thiếu một thông tin đăng nhập chỉ khiến trình kết nối đó bị bỏ qua chứ không làm hỏng cả tác nhân. Tác nhân vẫn khởi động và vẫn trả lời trong bảng điều khiển; một thông báo trên Overview nêu tên khóa còn thiếu và dẫn tới bảng trình kết nối để khắc phục.

Tác nhân hành xử ra sao trong một cuộc chat

Lệnh gạch chéo hoạt động trên mọi nền tảng nhắn tin, không chỉ trên bảng điều khiển. Văn bản gửi đến được đối chiếu với danh sách lệnh trước khi tới mô hình, vì vậy /help, /new, /context, /tools/skills đều được thực thi thay vì bị trả lời như một câu hỏi. Tác nhân lộ ra lệnh nào được đặt riêng theo từng tác nhân, trong tab Lệnh tab, nơi các lệnh nhạy cảm bị tắt theo mặc định và bạn có thể tự định nghĩa phím tắt riêng.

Việc thấy được bao nhiêu phần công việc của tác nhân trong một cuộc chat được đặt riêng theo từng cuộc trò chuyện bằng /quiet, /normal/verbose. Bình thường hiện một danh sách việc cần làm trực tiếp và một dòng cho mỗi lần gọi công cụ trong lúc tác nhân làm việc, rồi thay nó bằng câu trả lời. Im lặng chỉ hiện câu trả lời - lựa chọn đúng cho một bot tiếp xúc khách hàng, và có thể đặt làm mặc định của tác nhân để nó áp dụng từ tin nhắn đầu tiên.

Cách ứng xử trong nhóm khác nhau tùy nền tảng và đáng để kiểm tra. WhatsApp mặc định xử lý mọi tin nhắn nhóm; hãy chuyển Lắng nghe nhóm thành “chỉ khi được @nhắc tên” nếu vậy là quá hăng, hoặc dùng chế độ chỉ nghe để tác nhân theo dõi một nhóm mà không bao giờ trả lời. Telegram có một thiết lập chính sách nhóm quyết định liệu thành viên không nằm trong danh sách có được trò chuyện trong nhóm hay không, trong khi tin nhắn trực tiếp vẫn bị chặn.

Kết nối tài khoản doanh nghiệp

Đây Kết nối mục này chứa mỗi dịch vụ bên ngoài mà bạn đăng nhập vào một thẻ: Google (Gmail, Calendar, Drive, Docs, Sheets), Microsoft 365, Salesforce, QuickBooks, X, Meta cho Facebook và Instagram, LinkedIn, Reddit, Fitbit, Shopify, Buffer, DocuSign, GitHub và GitHub CLI. Mỗi thẻ hiển thị trạng thái của nó và những gì nó kích hoạt.

Kết nối dùng luồng sao chép liên kết: bảng điều khiển đưa cho bạn nút Mở trang cấp quyền và một nút Sao chép liên kết nút. Mở nó trên bất kỳ thiết bị nào - laptop của bạn, điện thoại của bạn - phê duyệt ở đó, rồi bảng điều khiển sẽ tự chuyển thành Đã kết nối . Trước khi bạn cấp quyền, bảng điều khiển hiển thị URI chuyển hướng chính xác cần đăng ký trong bảng điều khiển của nhà cung cấp, kèm nút sao chép; hãy đăng ký đúng y như hiển thị, nếu không nhà cung cấp sẽ từ chối việc cấp quyền.

Có hai phạm vi khả dụng. Hệ thống nghĩa là một kết nối duy nhất mà mọi tác nhân đều dùng chung. Theo từng tác nhân cấp cho tác nhân đó tài khoản riêng, kèm công tắc chia sẻ tùy chọn để những tác nhân khác có thể quay lại dùng nó. Sau khi kết nối, các công cụ tự lấy thông tin đăng nhập mà không cần cấu hình thêm, và token tự làm mới ở nơi nhà cung cấp hỗ trợ điều đó.

Gộp lại, những tài khoản này, các bộ công cụ dựng sẵn, và các tiện ích riêng của nền tảng cho một tác nhân quyền truy cập vào hơn 450 công cụ kết nối trải khắp hơn 75 tích hợp dựng sẵn - dù vậy, như chương 2 đã nói, một tác nhân chỉ nên giữ những gì công việc của nó cần.

Mẹo

Nếu người cần đăng nhập không ngồi trước bảng điều khiển, một quản trị viên có thể tạo một liên kết ma thuật tồn tại trong thời gian ngắn, được bảo vệ bằng mã PIN, từ Cấu hình → Liên kết ma thuật. Nó mở ra một trang nhỏ thực hiện việc đăng nhập thật, và báo lại cho cuộc trò chuyện gốc khi hoàn tất. Liên kết và mã PIN chỉ hiện ra một lần và không thể tra lại được nữa.

máy chủ MCP

Máy chủ MCP là các dịch vụ bên ngoài công bố những công cụ mà một tác nhân có thể gọi. Thư mục này chứa hơn 200 máy chủ MCP, và tab MCP tab là nơi bạn thêm chúng vào.

Biểu mẫu có hướng dẫn bắt đầu bằng Kết nối một dịch vụ bộ chọn cấu hình dựng sẵn bao trùm các nhà cung cấp đã xác minh - Stripe, HubSpot, Notion, GitHub, Linear, Sentry, Canva và nhiều hơn - tự điền sẵn địa chỉ và chỉ hiện những trường mà nhà cung cấp đó cần. Chi tiết truyền tải, tiêu đề và phạm vi được thu gọn dưới một Nâng cao khối mở rộng, và một Tùy chỉnh tùy chọn giữ lại biểu mẫu đầy đủ cho bất kỳ thứ gì không có trong danh sách.

Kết nối sẽ dò máy chủ bằng nhật ký từng bước, tìm ra nó cần gì, và - nếu nó đòi đăng nhập - khởi chạy luồng cấp quyền thay bạn. Bạn phê duyệt ngay trên trang riêng của nhà cung cấp và cái bắt tay hoàn tất khi chuyển hướng xong. Sau đó, các viên trạng thái theo từng máy chủ sẽ hiện tình trạng kết nối và trạng thái đăng nhập, kể cả một viên token biết nhận diện hết hạn, chuyển sang màu đỏ kèm nút Cấp quyền lại thay vì giả vờ như một token đã hết hạn vẫn ổn.

Có hai điều tiện lợi quan trọng hằng ngày. Bạn có thể bật hoặc tắt từng công cụ riêng lẻ mà một máy chủ công bố, nên một máy chủ cung cấp bốn mươi công cụ vẫn có thể chỉ đóng góp ba công cụ bạn muốn. Và nút Tải lại tác nhân sẽ đổi các công cụ mới vào tác nhân đang chạy mà không cần khởi động lại, nên một máy chủ vừa được cấp quyền có thể dùng được ngay lập tức.

Webhook

Đây Webhook tab xử lý cả hai chiều.

Gửi đi gửi các sự kiện của tác nhân đến một URL do bạn chọn. Bạn đặt cho nó một tên, một URL tải trọng, các sự kiện cần gửi, và tùy chọn thêm một mã bí mật ký để bên nhận có thể xác minh việc gửi. Giới hạn tốc độ, số lần thử lại, thời gian chờ và xác minh TLS đều cấu hình được, và mỗi hàng hiển thị số lần thành công và thất bại theo thời gian thực.

Nhận vào là nửa thú vị hơn: nó cho phép một hệ thống bên ngoài trao tải trọng cho tác nhân. Bạn viết một prompt xử lý mô tả webhook đó là gì và cách xử lý nó - mọi trường mà bên gửi đăng lên đều được tự động gắn thêm vào - và chọn xem tác nhân có trả lời đồng bộ cho bên gửi hay không, và liệu các tải trọng có dồn vào một cuộc trò chuyện hay mỗi lần bắt đầu lại từ đầu. Sau khi lưu, hàng đó hiển thị một URL đầu vào tự xác thực kèm nút sao chép; đưa nó cho bất kỳ ai đang gửi dữ liệu.

Cả hai loại đều có nút Kiểm tra kích hoạt một mẫu thử và hiện kết quả, và một khung nhìn Lịch sử về các lần gửi trước đây. Chỉnh sửa có hiệu lực ngay.