GPT Actions: Kết nối với các dịch vụ bên ngoài

Đây là cách bạn tạo ra các GPT có khả năng kiểm tra tồn kho trực tuyến, tra cứu hồ sơ khách hàng, tạo sự kiện lịch hoặc gửi thông báo.

Trong bài học trước, bạn đã cấu hình các tính năng và luồng hội thoại. "Actions" tiến xa hơn thế - thay vì chỉ sử dụng những công cụ có sẵn, bạn có thể kết nối GPT của mình với bất kỳ dịch vụ bên ngoài nào có hỗ trợ API.

GPT Actions là gì?

Actions chuyển đổi ngôn ngữ tự nhiên thành các lệnh gọi API. Quy trình diễn ra như sau:

1. Người dùng nói: "Giá cổ phiếu hiện tại của Apple là bao nhiêu?"

2. GPT chuyển đổi: Gọi API giá cổ phiếu với tham số "AAPL"

3. API phản hồi: Trả về dữ liệu {"price": 198.50, "change": "+1.2%"}

4. GPT hiển thị: "Apple (AAPL) hiện đang giao dịch ở mức 198,50 USD, tăng 1,2% trong ngày hôm nay."

Người dùng không cần nhìn thấy quá trình gọi API. Họ chỉ đơn giản là trò chuyện tự nhiên, còn GPT sẽ xử lý các công việc kỹ thuật ở phía sau.

OpenAPI Specification

Các Actions được định nghĩa bằng cách sử dụng OpenAPI Specification (trước đây gọi là Swagger). Đây là một định dạng chuẩn dùng để mô tả các endpoint, tham số và phản hồi của API.

Dưới đây là một ví dụ đơn giản hóa dành cho API thời tiết:

• Mở ChatGPT (chat.openai.com), Claude (claude.ai) hoặc Gemini (gemini.google.com) và bắt đầu một cuộc trò chuyện mới.

• Sao chép câu lệnh (prompt) này:

openapi: 3.1.0
info:
  title: Weather API
  version: 1.0.0
servers:
  - url: https://api.weather.example.com
paths:
  /current:
    get:
      summary: Get current weather for a city
      operationId: getCurrentWeather
      parameters:
        - name: city
          in: query
          required: true
          schema:
            type: string
          description: The city name
      responses:
        '200':
          description: Weather data returned

Đừng lo lắng về việc phải viết nội dung này từ đầu - bạn có thể yêu cầu chính ChatGPT tạo OpenAPI schema cho bất kỳ API nào mà bạn mô tả.

Thiết lập một Action (Hành động)

Trong GPT Builder, hãy vào mục Đinh cấu hình → cuộn xuống phần Hành động → nhấp vào Tạo hành động mới.

Bước 1: Xác định schema

Dán OpenAPI Specification của bạn vào. Nếu chưa có, hãy mô tả API đó cho ChatGPT:

Hãy tạo OpenAPI Specification 3.1 cho một API thời tiết. Endpoint là GET https://api.weather.example.com/current với tham số truy vấn bắt buộc là 'city', trả về thông tin nhiệt độ, điều kiện thời tiết và độ ẩm.\

Bước 2: Cấu hình xác thực

Chọn một trong các phương thức:

• None - Dành cho các API công khai không yêu cầu xác thực

• API Key - Bạn cung cấp một key được gửi kèm trong mỗi yêu cầu

• OAuth - Dành cho các dịch vụ mà mỗi người dùng thực hiện xác thực riêng biệt

Bước 3: Thêm hướng dẫn

Cho GPT biết khi nào và làm thế nào để sử dụng hành động này:

Khi người dùng hỏi về thời tiết:
→ Sử dụng hành động `getCurrentWeather` với tên thành phố
→ Trình bày kết quả theo định dạng: "Tại [city], hiện tại
  [temperature]°F và [condition]. Độ ẩm là [humidity]%.

Cách điền thông tin chi tiết: Thay thế các phần nằm trong dấu ngoặc vuông [] bằng thông tin cụ thể trong trường hợp thực tế của bạn. Đầu vào mơ hồ sẽ tạo ra kết quả mơ hồ - hãy đưa ra thông tin cụ thể, rõ ràng.

Những gì bạn sẽ thấy: Chỉ trong vài giây, AI sẽ trả về một phản hồi có cấu trúc dựa trên câu lệnh ở trên. Hãy đọc kỹ và coi đó là bản nháp, không phải là câu trả lời cuối cùng.

Cách xử lý kết quả đầu ra: Lưu lại phản hồi vào file ghi chú (Notes). Chọn ra một gợi ý mang lại hiệu quả cao nhất và thực hiện nó trong tuần này - đừng cố gắng làm tất cả mọi thứ cùng một lúc.

Nếu kết quả chưa phù hợp: Nếu các gợi ý có vẻ chung chung, hãy dán nội dung sau: "Hãy đưa ra thông tin cụ thể hơn dựa trên bối cảnh thực tế của tôi. Bỏ qua những lời khuyên chung chung". Nếu hệ thống bỏ sót các chi tiết quan trọng mà bạn đã cung cấp, hãy thêm yêu cầu: "Bạn đã bỏ sót [X] trong bối cảnh của tôi - hãy thực hiện lại và coi đó là yêu cầu bắt buộc hàng đầu".

Tìm hiểu sâu về xác thực

API Key là lựa chọn phổ biến nhất. Bạn lấy key từ nhà cung cấp API, dán vào công cụ tạo GPT, và mọi yêu cầu gửi đi sẽ tự động bao gồm key này.

OAuth dành cho các trường hợp nâng cao, nơi mỗi người dùng cần thông tin xác thực riêng - chẳng hạn như khi truy cập vào Google Calendar hoặc không gian làm việc Slack cá nhân của họ.

Các ý tưởng Action thực tế

Khi nào Actions không phải là lựa chọn phù hợp?

Actions có những hạn chế sau:

• Độ trễ: Các lệnh gọi API cần thời gian xử lý - phản hồi sẽ chậm hơn so với việc tra cứu từ file kiến ​​thức.

• Độ tin cậy: Các API bên ngoài có thể gặp sự cố, bị giới hạn tốc độ truy cập hoặc thay đổi cấu trúc.

• Độ phức tạp: Việc gỡ lỗi các vấn đề liên quan đến API đòi hỏi một số kiến ​​thức kỹ thuật nhất định.

• Quyền riêng tư: Dữ liệu sẽ truyền qua máy chủ của OpenAI để đến API.

Đối với thông tin tĩnh ít thay đổi, việc sử dụng file kiến ​​thức sẽ đơn giản và đáng tin cậy hơn. Hãy sử dụng Actions khi bạn thực sự cần dữ liệu trực tiếp theo thời gian thực.

Bài tập thực hành

Ngay cả khi không có API tùy chỉnh, bạn vẫn có thể thực hành với Actions:

1. Mở GPT của bạn và vào mục Định cấu hình → Hành động → Tạo hành động mới.

2. Yêu cầu ChatGPT: "Tạo OpenAPI Specification cho một joke API công khai tại địa chỉ https://official-joke-api.appspot.com/random_joke".

3. Dán schema vừa được tạo vào trình chỉnh sửa Action.

4. Thiết lập xác thực là None (Không xác thực).

5. Thêm hướng dẫn: "Khi người dùng yêu cầu một câu chuyện cười, hãy sử dụng joke action lấy truyện cười".

6. Kiểm tra thử trong bảng Xem trước.

Việc này giúp bạn có trải nghiệm thực tế về quy trình thiết lập Action thông qua một API đơn giản và miễn phí.

Những điểm chính cần ghi nhớ

• Actions chuyển đổi ngôn ngữ tự nhiên thành các lệnh gọi API, cho phép GPT tương tác với các dịch vụ bên ngoài.

• Chúng sử dụng định dạng OpenAPI Specification - hãy nhờ ChatGPT tạo schema giúp bạn.

• Có ba tùy chọn xác thực: None (Không xác thực), API Key và OAuth.

• Sử dụng Actions cho dữ liệu trực tiếp; sử dụng file kiến ​​thức cho các tài liệu tham khảo tĩnh.

• Luôn thêm hướng dẫn để chỉ định cho GPT biết khi nào và làm thế nào để sử dụng từng action.