Chuyển tới nội dung chính

Quy trình phát triển AI App

1. Đăng nhập vào V-Console và Tạo tài khoản​

Đăng nhập vào để tạo tài khoản​

Hiện tại, để tạo được tài khoản cho V-Console, bạn phải đăng nhập ít nhất một lần tại https://console.v-app.vn.

Trở thành thành viên Tổ chức​

Team TMĐT đã tạo sẵn tổ chức cho các PnLs nội bộ nên các bạn Quản lý hãy liên hệ team để được hỗ trợ thêm vào Tổ chức với quyền Quản trị. Sau đó, các bạn có thể thêm các thành viên khác vào tổ chức. Lưu ý là tài khoản thành viên phải đăng nhập ít nhất một lần vào V-Console để có tài khoản.

Liên kết SĐT và địa chỉ email để sử dụng DevAssistant​

  • Bước 1: Đăng nhập V-Console dùng account AD hoặc email đã đăng ký trước đó
  • Bước 2: Liên kết số điện thoại sẽ dùng để test trên V-app
  • Bước 3: Đăng nhập V-app với số điện thoại trên và mở DevAssistant (scan QR code) và bạn có thể thấy những miniapp bạn có access giống như bên V-Console
Lưu ý

Nếu số điện thoại ở bước 2 đã được sử dụng ở một tài khoản khác thì cần phải đổi qua một số điện thoại khác. Hiện tại có thể dùng bất kỳ số điện thoại nào vì đang dùng OTP 123456 trên UAT

2. Tạo và cấu hình AI App​

2.1 Tạo AI App​

Các bạn có quyền Quản trị trên tổ chức có thể chủ động tạo AI App trên V-Console.

Tạo AI App

2.2 Cấu hình​

Bạn có thể cấu hình các thông tin như MCP Endpoint, cơ chế xác thực, nội dung hiển thị trên thông báo ủy quyền chia sẻ thông tin người dùng trong Chi tiết AI App > Cài đặt.

Cấu hình AI App

3 Phát triển​

3.1. Bộ công cụ phát triển AI App​

Chúng tôi cung cấp bộ công cụ phát triển bao gồm:

  • CLI: công cụ dòng lệnh cung cấp khởi tạo dự án, chạy thử và upload mã nguồn lên hệ thống.
  • Inspector: công cụ kiểm thử MCP, tích hợp cơ chế kiểm thử skill và tool.
  • Framework: framework phát triển AI App theo chuẩn MCP, tối ưu để chạy trên V-App.
  • JS APIs: bộ JS APIs để tưởng tác với Host App.
  • MiniApp UI: bộ components tiêu chuẩn.

Ngoài những API/Components liên quan tới frontend thì chúng tôi cung cấp những Server APIs để cho phép backend của các AI App có thể thay mặt user thực hiện một số tác vụ:

3.2. Quy trình phát triển​

  • Nhà phát triển sẽ sử dụng CLI để khởi tạo dự án.
  • Kiểm tra tính tuân thủ về ANBM của AI App.
  • Tự deploy lên môi trường UAT/PROD của đối tác.

3.3. Gửi duyệt và phát hành​

Sau khi deploy AI App / MCP, thực hiện quy trình gửi duyệt trên V-Console thông qua các bước:

Gửi duyệt AI App
  1. Thông tin:
    • Điền thông tin metadata của AI như tên, mô tả
    • Điền địa chỉ email, hotline hỗ trợ
    • Đường dẫn đến Điều khoản dịch vụ, Chính sách bảo vệ dữ liệu cá nhân
  2. MCP Server:
    • Điền MCP Endpoint
    • Quét thử để hệ thống kiểm tra có lấy được thông tin Skills & Tools từ MCP hay không
    • Xác thực tên miền MCP
  3. Kiểm thử:
    • Điền các kịch bản kiểm thử hợp lệ - kịch bản dùng để kích hoạt Skill hoặc Tool của AI App
    • Điền các kịch bản ngoại lệ - kịch bản không kích hoạt được Skill hoặc Tool
  4. Gửi duyệt:
    • Điền nội dung ghi chú và phát hành
    • Nhấn nút Gửi duyệt

Khi thông qua phê duyệt, AI App / MCP sẽ được index lên hệ thống của V-AI mà không cần nhấn nút Phát hành.