> For the complete documentation index, see [llms.txt](https://docs.clickai.vn/clickai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clickai.vn/clickai-docs/nha-phat-trien/khong-gian-lam-viec.md). # Không gian làm việc

## 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 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)*