Trang này hướng dẫn dùng một REST API connector đã tạo ở Workspace trong từng Agent. Nếu chưa có Connector, xem Kết nối Custom API trên Space để tạo trước.
Lối vào
Agent của tôi → mở Agent → Dựng agent → panel Cấu hình → mục Kết nối → dấu +.Gắn Connector vào Agent
1
Mở mục Kết nối của Agent
Mở Agent, ở màn hình Dựng agent chọn panel Cấu hình, nhấn dấu + ở mục Kết nối.
2
Chọn kiểu tài khoản
Chọn Dùng chung (một tài khoản của Workspace) hoặc Theo người dùng (tài khoản riêng của mỗi người).
3
Tích Connector rồi nhấn Xong
Custom Connector nằm chung danh sách với Connector có sẵn. Tích Connector cần dùng rồi nhấn Xong. Nút Tạo connector mới ở góc dưới mở cùng hộp thoại tạo REST API như trên trang Kết nối.
4
Mở rộng Connector để xem các thao tác
Connector xuất hiện trong mục Kết nối kèm kiểu tài khoản và số ngoại lệ. Nhấn vào dòng Connector để xem tài khoản đang dùng và quyền của từng thao tác.
Với Dùng chung, phần Tài khoản cho biết Agent đang dùng tài khoản nào. Nhấn biểu tượng đổi tài khoản để chọn tài khoản khác, Thêm tài khoản hoặc Quản lý tài khoản.
Trên một Agent, mỗi Connector chỉ gắn được theo một kiểu. Connector đã gắn kiểu Dùng chung sẽ hiện nhãn Đã thêm trong hộp chọn Theo người dùng. Muốn đổi kiểu, gỡ Connector rồi gắn lại.
Đặt quyền cho từng thao tác
Mỗi thao tác có ba mức quyền:
Số ngoại lệ cạnh tên Connector cho biết có bao nhiêu thao tác đang khác mức mặc định. Ví dụ dưới đây đặt Huỷ đơn hàng về Chặn để Agent không thể huỷ đơn.
Chạy thử Agent với Connector
1
Gửi yêu cầu ở tab Chạy thử
Mở tab Chạy thử và gửi một yêu cầu cần đến API, ví dụ: Tạo đơn hàng cho khách Trần Thị B, tổng tiền 250000.
2
Duyệt hoặc từ chối thao tác
Với thao tác ở mức Hỏi, thẻ Cần bạn phê duyệt hành động hiện tên thao tác và các tham số Agent định gửi. Nhấn Duyệt để gọi API. Nhấn Từ chối để không gọi, có thể nhập Lý do từ chối để Agent điều chỉnh.
3
Xem tham số và kết quả
Sau khi Agent trả lời, mở Đã gọi N công cụ rồi mở tên công cụ để xem Tham số đã gửi và Kết quả API trả về.
Thay đổi Connector trong Agent được tự động lưu vào bản nháp. Người dùng cuối chỉ thấy thay đổi sau khi bạn Publish phiên bản mới của Agent.
Gỡ Connector khỏi Agent
Nhấn biểu tượng thùng rác ở dòng Connector trong mục Kết nối. Connector được gỡ ngay, không có hộp thoại xác nhận. Connector vẫn còn trong Workspace và có thể gắn lại bất cứ lúc nào.Khi Connector được import lại ở Space, thao tác bị xoá hoặc đổi tên trong tài liệu mới không còn trong Agent. Mở lại mục Kết nối của Agent để kiểm tra quyền và chạy thử lại.
Lỗi thường gặp
Xem thêm
Kết nối Custom API trên Space
Tạo, sửa, import lại và xoá Connector.
Kết nối (Connectors)
Cách gắn Connector có sẵn và các mức quyền cho công cụ.