Triển khai ứng dụng
Đưa ứng dụng AI của bạn đến tay người dùng qua Web App, API, Embed, và MCP Server. ClickAI Publish Options
lục
· [Tổng quan](#tổng-quan)
· [Các phương thức triển khai](#các-phương-thức-triển-khai)
· [Hướng dẫn tích hợp API](#hướng-dẫn-tích-hợp-api)
· [Quản lý conversation_id](#quản-lý-conversation_id)
· [Best Practices](#best-practices)
Tổng quan
Sau khi build xong ứng dụng AI trên ClickAI Studio, bạn có nhiều cách để triển khai. Quy trình đơn giản:
1. ✅ Build xong ứng dụng
2. 🔘 Nhấn Publish
3. 📋 Chọn phương thức triển khai
4. 🔗 Copy URL / API Key
5. 🌐 Chia sẻ ngay
Các phương thức triển khai
1. Web App
Triển khai dưới dạng trang web độc lập, chia sẻ ngay lập tức.
Thuộc tính
Chi tiết
Tốc độ
⚡ Ngay lập tức
Yêu cầu
Không cần coding
URL
https://app.clickai.vn/chat/<app-id>
ClickAI hỗ trợ 2 loại Web App:
· Chatbot / Agent Web App: Giao diện chat real-time, multi-turn conversation
· Workflow Web App: Form nhập liệu cho batch processing, quản lý kết quả
Cách triển khai:
6. Mở ứng dụng trong ClickAI Studio
7. Nhấn nút "Publish" ở góc trên phải
8. Chọn tab "Web App"
9. Copy URL và chia sẻ cho người dùng
2. API Integration
Tích hợp AI vào bất kỳ ứng dụng nào qua RESTful API.
Thuộc tính
Chi tiết
Base URL
https://api.clickai.vn/v1
Xác thực
Bearer Token (API Key)
Response
JSON / Server-Sent Events (streaming)
⚠️ IMPORTANT: API Key (Secret Key) không bao giờ được expose ở client-side. Luôn gọi API từ backend server.
3. Embed vào Website
Nhúng trực tiếp ứng dụng AI vào website hiện có:
iFrame:
<iframe src="https://app.clickai.vn/chatbot/<app-id>?embed=true" style="width: 100%; height: 600px; border: none;" allow="microphone"> </iframe>
Chat Bubble Script:
<script> window.clickaiChatbotConfig = { token: 'YOUR_APP_TOKEN', baseUrl: 'https://api.clickai.vn' } </script> <script src="https://app.clickai.vn/embed.min.js" defer></script>
4. MCP Server
Triển khai dưới dạng Model Context Protocol Server — cho phép AI client khác (Claude Desktop, VS Code Copilot) gọi đến ứng dụng.
Hướng dẫn tích hợp API
Xác thực
Authorization: Bearer {YOUR_SECRET_KEY}
Text Generation App
curl -X POST 'https://api.clickai.vn/v1/completion-messages' \ -H 'Authorization: Bearer YOUR-SECRET-KEY' \ -H 'Content-Type: application/json' \ -d '{ "inputs": {"text": "Viết email cảm ơn khách hàng"}, "response_mode": "streaming", "user": "user-123" }'
import requests, json url = "https://api.clickai.vn/v1/completion-messages" headers = { 'Authorization': 'Bearer YOUR-SECRET-KEY', 'Content-Type': 'application/json', } data = { "inputs": {"text": "Viết email cảm ơn khách hàng"}, "response_mode": "streaming", "user": "user-123" } response = requests.post(url, headers=headers, data=json.dumps(data)) print(response.text)
Conversational App (Chatbot / Agent)
curl -X POST 'https://api.clickai.vn/v1/chat-messages' \ -H 'Authorization: Bearer YOUR-SECRET-KEY' \ -H 'Content-Type: application/json' \ -d '{ "inputs": {}, "query": "Xin chào, tôi cần hỗ trợ", "response_mode": "streaming", "conversation_id": "", "user": "user-123" }'
Workflow App
curl -X POST 'https://api.clickai.vn/v1/workflows/run' \ -H 'Authorization: Bearer YOUR-SECRET-KEY' \ -H 'Content-Type: application/json' \ -d '{ "inputs": {"input_text": "Dữ liệu cần xử lý"}, "response_mode": "streaming", "user": "user-123" }'
Quản lý conversation_id
Tình huống
Cách xử lý
Cuộc hội thoại mới
Để trống conversation_id → Hệ thống tạo ID mới
Tiếp tục hội thoại
Gửi kèm conversation_id đã nhận
Thay đổi biến giữa phiên
Dùng Conversation Variables
🚨 WARNING: Khi truyền `conversation_id` hiện có, giá trị `inputs` sẽ bị bỏ qua. Chỉ `query` được xử lý.
Best Practices
Trước khi Publish
· ☐ Mô tả ứng dụng rõ ràng
· ☐ Icon & Branding chuyên nghiệp
· ☐ Thiết lập Access Controls
· ☐ Cấu hình Rate Limits cho API
Chọn phương thức phù hợp
Mục tiêu
Phương thức
Feedback nhanh từ người dùng
Web App
Xây dựng sản phẩm riêng
API
Website sẵn muốn thêm AI
Embed
Mở rộng AI tools
MCP Server
📖 Trước: [Build](./01-build.md) · Tiếp: [Monitor](./03-monitor.md)
Last updated