Không gian làm việc

Workspace là đơn vị tổ chức nền tảng trong ClickAI — mọi thứ team bạn xây dựng, cấu hình và quản lý đều tồn tại trong một workspace.

Mục lục

· [Tổng quan](#tổng-quan)

· [Mô hình Workspace](#mô-hình-workspace)

· [Tạo Workspace](#tạo-workspace)

· [Model Providers](#model-providers)

· [Plugins](#plugins)

· [Tools](#tools)

· [Quản lý ứng dụng](#quản-lý-ứng-dụng)

· [Quản lý thành viên](#quản-lý-thành-viên)

· [Cài đặt cá nhân](#cài-đặt-cá-nhân)

Tổng quan

Workspace là trung tâm điều khiển cho mọi hoạt động trên ClickAI. Tất cả tài nguyên — ứng dụng, knowledge base, model configs, team members — đều được tổ chức trong workspace.

Mô hình Workspace

🏢 Tổ chức của bạn └── 📁 Workspace ├── 🤖 Apps (chatbots, workflows, agents) ├── 📊 Knowledge Bases (documents, embeddings) ├── 👥 Team Members (roles & permissions) ├── 🧠 Model Providers (API keys, configurations) ├── 🔧 Tools & Plugins (integrations, custom code) └── 💳 Billing (subscription, limits, usage)

Cách các tài nguyên kết nối

Vai trò	Quyền hạn
Owner	Quản lý billing, model providers, workspace settings
Admin	Quản lý team members, cấu hình models/plugins
Editor	Xây dựng ứng dụng, quản lý knowledge bases
Member	Sử dụng ứng dụng đã publish

Tạo Workspace

1. Đăng nhập vào ClickAI tại https://app.clickai.vn

2. Click vào workspace selector ở header

3. Chọn "+ Create Workspace"

4. Đặt tên workspace và mô tả

5. Mời thành viên team (tùy chọn)

📝 NOTE: Mỗi tài khoản có thể tạo hoặc tham gia nhiều workspace. Dữ liệu giữa các workspace hoàn toàn độc lập.

Model Providers

Cấu hình các nhà cung cấp AI model — nền tảng powering mọi ứng dụng.

Các provider được hỗ trợ

Provider	Models tiêu biểu	Loại
OpenAI	GPT-4o, GPT-4o-mini, o1, o3	LLM, Embedding
Anthropic	Claude 4 Opus, Sonnet, Haiku	LLM
Google	Gemini 2.5 Pro, Flash	LLM
Azure OpenAI	Tất cả GPT models	LLM, Embedding
DeepSeek	DeepSeek-V3, R1	LLM
Groq	Llama 3, Mixtral	LLM
Cohere	Command R+, Embed	LLM, Rerank
Jina AI	Jina Embeddings	Embedding

Cấu hình Model Provider

6. Vào Settings → Model Providers

7. Chọn provider muốn kết nối

8. Nhập API Key của provider

9. Test kết nối → Lưu

⚠️ IMPORTANT: API Key của model providers được mã hóa và lưu trữ an toàn. Chỉ Owner và Admin mới có thể xem và chỉnh sửa API Keys.

Model Types

Loại	Chức năng	Dùng ở đâu
LLM	Sinh văn bản, suy luận	Node LLM trong Workflow
Text Embedding	Chuyển text → vector	Knowledge Base indexing
Rerank	Sắp xếp lại kết quả tìm kiếm	Knowledge Retrieval
Speech-to-Text	Chuyển giọng nói → text	App Toolkit STT
Text-to-Speech	Chuyển text → giọng nói	App Toolkit TTS
Moderation	Kiểm duyệt nội dung	Content Moderation

Plugins

Mở rộng khả năng của ClickAI thông qua hệ thống plugin.

Plugin Marketplace

Duyệt và cài đặt plugins từ marketplace:

10. Vào Plugins từ sidebar

11. Duyệt Marketplace hoặc tìm kiếm

12. Nhấn "Install" trên plugin cần dùng

13. Cấu hình credentials nếu yêu cầu

Loại Plugins

Loại	Mô tả	Ví dụ
Tool	Thêm công cụ cho Agent/Workflow	Google Search, Weather API
Model	Thêm model providers	Custom LLM endpoint
Extension	Mở rộng tính năng platform	Content moderation API
Bundle	Gói kết hợp nhiều loại	Full integration suite

Custom Plugins

Tạo plugin tùy chỉnh cho nhu cầu riêng — xem tài liệu phát triển plugin.

Tools

Quản lý các công cụ mà Agent và Workflow có thể sử dụng.

Built-in Tools

ClickAI cung cấp sẵn các tool phổ biến:

Tool	Chức năng
Web Search	Tìm kiếm thông tin trên internet
Wikipedia	Tra cứu Wikipedia
Calculator	Tính toán toán học
Current Time	Lấy thời gian hiện tại
Weather	Tra cứu thời tiết

Custom Tools (API-based)

Kết nối API bên ngoài thành tool cho AI sử dụng:

14. Vào Tools → "+ Create Custom Tool"

15. Nhập OpenAPI/Swagger specification của API

16. Cấu hình authentication

17. Test tool → Lưu

18. Tool sẽ xuất hiện trong danh sách tools khi build App

# Ví dụ OpenAPI Spec cho Custom Tool openapi: 3.0.0 info: title: CRM Lookup version: 1.0.0 paths: /api/customers/{id}: get: summary: Tra cứu thông tin khách hàng parameters: - name: id in: path required: true schema: type: string

Quản lý ứng dụng

Danh sách ứng dụng

Trang Apps hiển thị tất cả ứng dụng trong workspace dưới dạng grid cards:

· App name & icon — Tên và biểu tượng ứng dụng

· App type — Chatbot, Workflow, Agent

· Status — Active, Draft, Paused

· Last updated — Thời gian cập nhật gần nhất

· Team members — Ai đang làm việc trên app

Các thao tác quản lý

Thao tác	Mô tả
Create	Tạo ứng dụng mới
Duplicate	Nhân bản ứng dụng
Export	Xuất DSL (YAML) để backup hoặc chia sẻ
Import	Nhập ứng dụng từ file DSL
Delete	Xóa ứng dụng (không thể hoàn tác)
Tag	Gắn tag phân loại

Bộ lọc & Tìm kiếm

· Filter theo type: All Apps, Chatbots, Workflows, Agents

· Search theo tên ứng dụng

· Sort theo tên, ngày tạo, ngày cập nhật

Quản lý thành viên

Mời thành viên

19. Vào Settings → Members

20. Nhấn "+ Invite"

21. Nhập email → Chọn role → Gửi lời mời

Hệ thống phân quyền

Quyền	Owner	Admin	Editor	Member
Quản lý billing	✅	❌	❌	❌
Cấu hình model providers	✅	✅	❌	❌
Quản lý team members	✅	✅	❌	❌
Cài đặt plugins	✅	✅	❌	❌
Build & edit ứng dụng	✅	✅	✅	❌
Quản lý knowledge	✅	✅	✅	❌
Xem logs & analytics	✅	✅	✅	❌
Sử dụng ứng dụng	✅	✅	✅	✅

🚨 WARNING: Chỉ có **Owner** mới có thể chuyển quyền ownership hoặc xóa workspace. Hãy cân nhắc kỹ khi thay đổi owner.

Cài đặt cá nhân

Thông tin tài khoản

Quản lý hồ sơ cá nhân:

· Tên hiển thị — Tên hiển thị trong workspace

· Email — Email đăng nhập (không thể thay đổi)

· Avatar — Ảnh đại diện

· Password — Đổi mật khẩu

· Language — Ngôn ngữ giao diện (Tiếng Việt, English, ...)

API Keys cá nhân

Quản lý API keys cho tài khoản:

22. Vào Personal Settings → API Keys

23. Nhấn "+ Create API Key"

24. Đặt tên mô tả → Copy key

25. Sử dụng key này cho CLI hoặc API management

Integrations

Kết nối tài khoản với dịch vụ bên ngoài:

· GitHub — Import code, sync repositories

· Google — OAuth login, Google Drive access

· SSO — Single Sign-On qua SAML/OIDC

📖 Trước: [Knowledge](./04-knowledge.md)