Tổng quan

Bài viết này giải thích cách cấu hình hành động trong một GPT, bao gồm cách kết nối với API bên ngoài, xác định GPT có thể làm gì, cũng như quản lý xác thực, lược đồ và các hạn chế của không gian làm việc.

Để cấu hình một hành động, bạn cần thông tin chi tiết về API cho dịch vụ muốn kết nối, bao gồm thông tin xác thực và một lược đồ OpenAPI. Một GPT có thể dùng ứng dụng hoặc hành động, nhưng không thể dùng cả hai cùng lúc.

Mỗi hành động được xác định bởi hai thành phần chính: cách GPT xác thực với API và một lược đồ xác định API có thể làm gì.

Hạn chế

Nếu không gian làm việc của bạn không cho phép miền hành động nào, các hành động tùy chỉnh của GPT không thể thực thi vì không có miền hành động nào vượt qua kiểm tra danh sách cho phép. Điều này không nhất thiết có nghĩa là mọi khả năng hiển thị hoặc quyền truy cập GPT đều bị chặn.

Các hành động không khả dụng cho chế độ Pro. Khi bạn tạo hoặc chỉnh sửa GPT có hành động tùy chỉnh, bộ chọn mô hình chỉ hiển thị các mô hình không phải Pro có hỗ trợ hành động.

Chuyển sang tiện ích

Các hành động tùy chỉnh không được tự động chuyển sang khi GPT được chuyển thành tiện ích. Hãy thiết lập và kiểm thử một tích hợp thay thế trước khi sử dụng tiện ích cho công việc. Các hướng dẫn bên dưới vẫn áp dụng cho những GPT hiện có chưa được chuyển đổi mà bạn có quyền chỉnh sửa. Để biết hướng dẫn chuyển đổi, hãy xem: Câu hỏi thường gặp về việc ngừng cung cấp và chuyển đổi GPT tùy chỉnh.

Tạo hành động

Trong trình chỉnh sửa GPT, hãy vào mục Hành động rồi chọn Tạo hành động mới.

Sau đó, bạn sẽ cấu hình cách GPT kết nối và sử dụng API bên ngoài.

Sau khi cấu hình hành động, hãy kiểm thử trong phần Xem trước để xác nhận hành động hoạt động như mong đợi.

Xác thực

Xác thực kiểm soát cách GPT của bạn kết nối với API bên ngoài.

Tùy chọn có sẵn:

• Không: Không yêu cầu xác thực

• Khóa API: Sử dụng khóa bí mật để ủy quyền yêu cầu

• OAuth: Sử dụng đăng nhập của người dùng để truy cập dựa trên tài khoản

Khóa API

Sử dụng xác thực bằng khóa API để truy cập từ máy chủ đến máy chủ. Có thể cấu hình dưới dạng:

• Basic

• Bearer

• Header tùy chỉnh

OAuth

Dùng OAuth khi các hành động yêu cầu tài khoản người dùng. OAuth yêu cầu:

• Client ID và Client Secret

• URL ủy quyền và URL token

• Phạm vi và phương thức trao đổi token

Trình chỉnh sửa cung cấp URL gọi lại để hoàn tất luồng OAuth.

Lược đồ

Lược đồ xác định API của bạn có thể làm gì. Lược đồ cho ChatGPT biết:

• Cần gọi máy chủ nào

• Những điểm cuối nào khả dụng

• Chúng chấp nhận những tham số nào

• Cách nhận dạng từng hành động (ID thao tác)

Lược đồ phải được cung cấp dưới dạng đặc tả OpenAPI ở định dạng JSON hoặc YAML.

Thêm lược đồ

Bạn có thể thêm lược đồ theo ba cách:

• Dán trực tiếp vào trình chỉnh sửa

• Nhập từ URL

• Bắt đầu từ ví dụ có sẵn:

  • Thời tiết (JSON)

  • Cửa hàng thú cưng (YAML)

  • Mẫu trống

Nếu lược đồ hợp lệ, trình chỉnh sửa hiển thị các hành động đã phát hiện. Nếu không hợp lệ, lỗi xác thực sẽ được hiển thị.

Hạn chế trong không gian làm việc (Enterprise và Edu)

Nếu bạn thấy thông báo:


“Cài đặt của không gian làm việc của bạn không cho phép miền nào.”

Điều này nghĩa là các hành động bị hạn chế bởi cài đặt không gian làm việc của bạn.

• Quản trị viên có thể cho phép tất cả miền hoặc giới hạn hành động ở các miền đã phê duyệt.

• Nếu không miền nào được cho phép, bạn không thể dùng hành động.

Để biết các biện pháp kiểm soát cấp không gian làm việc đối với hành động và hạn chế miền, xem: Quản lý quyền truy cập GPT trong không gian làm việc Enterprise và Edu.

Quyền riêng tư và quyền kiểm soát của người dùng

• Mỗi hành động có thể bao gồm URL chính sách quyền riêng tư.

• Các GPT công khai (qua liên kết hoặc GPT Store) có hành động phải bao gồm URL chính sách quyền riêng tư hợp lệ.

• Người dùng có thể được yêu cầu phê duyệt hành động trước khi chạy.

• Với các hành động OAuth, người dùng có thể xem lại và quản lý các tài khoản đã kết nối.

Trợ giúp bổ sung

Để được trợ giúp viết hoặc gỡ lỗi hành động, hãy dùng ActionsGPT chính thức.