Kết nối tùy chỉnh

Bạn đang dùng trải nghiệm nào?

Các tài liệu này bao quát cả hai trải nghiệm. Nếu Cài đặt → Cá nhân → My Okou có sẵn, hãy làm theo các bước My Okou. Nếu bạn dùng trang Agents với New agent, hãy làm theo các bước Legacy Agents. Mức độ sẵn có có thể khác nhau giữa các thành viên; các tài liệu này không thay đổi trải nghiệm của bạn.

Trong cả hai trải nghiệm, bạn có thể chạy nhiều cuộc trò chuyện hoặc tác vụ cùng lúc, tái sử dụng quy trình làm việc và chia sẻ công việc đã được xem xét với nhóm của mình. Một subagent khi chạy là công cụ thực thi, không phải một hồ sơ sản phẩm riêng mà bạn cần tạo.

Khác biệt khi thiết lập: My Okou dùng Instructions cá nhân trong Cài đặt → Cá nhân → My Okou và Workflows của không gian làm việc. Bất kỳ bước nào bên dưới yêu cầu bạn chọn, tạo hoặc cấp quyền cho một tác nhân có tên chỉ áp dụng cho Legacy Agents. Trong My Okou, hãy dùng Chat của chính bạn và làm theo yêu cầu về tài khoản và quyền cụ thể theo tên được hiển thị. Các Workflows dùng chung không chia sẻ thông tin xác thực; Automations dùng ngữ cảnh và quyền truy cập của chủ sở hữu chúng.

Một trình kết nối tùy chỉnh cho phép quản trị viên tổ chức đăng ký một API HTTPS hoặc, khi được bật, một máy chủ MCP Streamable HTTP không có trong danh mục tích hợp sẵn. Nó xác định ranh giới mạng và phương thức xác thực. Nó không tự động tạo ra tài liệu tham chiếu API đầy đủ cho tác nhân.

Ai cấu hình gì

• Quản trị viên tổ chức tạo, chỉnh sửa và xóa định nghĩa kết nối.
• Thành viên kết nối bí mật của riêng họ hoặc hoàn tất luồng OAuth của kết nối.
• Xác thực và quyền kiểm soát những hành động có tên mà Okou có thể yêu cầu bằng kết nối. Legacy Agents cũng dùng xác thực dành riêng cho tác nhân.

Định nghĩa được chia sẻ trong tổ chức. Thông tin xác thực của thành viên vẫn được giới hạn cho thành viên và tổ chức.

Kết nối API HTTP

1. Mở Connectors → Custom và chọn New connector.
2. Chọn HTTP API và nhập tên hiển thị.
3. Thêm một hoặc nhiều Prefixes HTTPS, mỗi dòng một tiền tố. Một yêu cầu phải khớp với một tiền tố đã cấu hình trước khi connector có thể cấp quyền cho nó.
4. Thêm xác thực nếu API cần:
   • Xác thực API: nhập tên header và mẫu header chứa {{secret}}, ví dụ Authorization và Bearer {{secret}}.
   • OAuth 2.0: nhập URL ủy quyền, URL token, client ID, client secret, scopes và phương thức xác thực ở endpoint token. Đăng ký chính xác URL chuyển hướng được hiển thị trong biểu mẫu với nhà cung cấp.
5. Tạo connector. Sau đó, mỗi thành viên cần dùng nó sẽ chọn Connect và cung cấp bí mật của họ hoặc hoàn tất OAuth.
6. Xem lại và cấp quyền cho các quyền được đặt tên bắt buộc. Trong Legacy Agents, cũng chọn Agent dự định.

Việc thay đổi một định nghĩa OAuth hiện có hoặc thông tin xác thực client của nó sẽ ngắt các kết nối OAuth hiện tại. Thành viên phải kết nối lại sau thay đổi đó.

Kết nối MCP

Nếu MCP xuất hiện như một loại kết nối trong không gian làm việc của bạn, hãy nhập một điểm cuối MCP Streamable HTTP HTTPS và cấu hình xác thực API hoặc OAuth trong cùng biểu mẫu. Nếu MCP không được cung cấp trong bộ chọn, nghĩa là tính năng này chưa được bật cho không gian làm việc đó.

Dạy tác nhân quy trình API

Một trình kết nối tùy chỉnh cung cấp quyền truy cập mạng an toàn và chèn thông tin xác thực. Biểu mẫu tạo không tải lên hoặc tự động khám phá một tài liệu OpenAPI. Hãy cung cấp cho tác nhân điểm cuối, phương thức, tham số và phản hồi mong đợi trong yêu cầu, hoặc ghi lại quy trình đó trong một workflow kèm theo tài liệu tham chiếu API được đính kèm dưới dạng tệp.

Xác thực một trình kết nối mới bằng một yêu cầu hẹp, chỉ đọc tới một điểm cuối đã biết. Không có yêu cầu chung Test connection vì nhiều API không cung cấp một điểm cuối gốc có ý nghĩa.

Ranh giới bảo mật

• Chỉ chấp nhận các tiền tố HTTPS và điểm cuối MCP.
• Tường lửa chỉ chèn thông tin xác thực đã lưu vào các yêu cầu khớp.
• Bí mật đã lưu được mã hóa khi lưu trữ và không bị lộ cho tác nhân dưới dạng biến môi trường.
• Không đặt khóa, token hoặc client secret trong tin nhắn chat, hướng dẫn quy trình làm việc hoặc tệp đính kèm.
• Dùng thông tin xác thực dịch vụ với phạm vi upstream tối thiểu cần cho quy trình làm việc.

Khắc phục sự cố

Tiếp theo là gì

• Xem Quy trình làm việc để ghi lại các công việc lặp lại với kết nối tùy chỉnh.
• Xem Quyền truy cập để biết cách xử lý thông tin xác thực của kết nối tùy chỉnh.
• Xem Catalog trước khi tự xây dựng — dịch vụ của bạn có thể đã được hỗ trợ sẵn.