Công việc hằng ngày

Sử dụng workspace bot

Khởi động ArchiBot bên trong code-server và để nó làm việc: nó biết gì về môi trường Archibus của bạn, nó có thể và không thể làm gì, các prompt sẵn dùng, và nó khác Console chat như thế nào.

Thành viên khách hàngQuản trị viên khách hàngNgười vận hành nền tảng

Cập nhật lần cuối 29 tháng 6, 2026

Mỗi workspace Archibus đều đi kèm ArchiBot, một trợ lý AI được quản lý, chạy bên trong workspace và đã hiểu sẵn môi trường Archibus của bạn. Nó có thể đọc mã của bạn, xác thực các chế độ xem AXVW, chạy các truy vấn chỉ đọc trên cơ sở dữ liệu của workspace, tra cứu tài liệu tham chiếu Archibus và điều khiển ứng dụng đang chạy — tất cả mà không cần bạn thiết lập khóa hay ngữ cảnh. Hướng dẫn này dành cho bất kỳ ai làm việc trong code-server, bất kể vai trò của bạn là gì.

Để biết toàn bộ môi trường xung quanh nó — trình soạn thảo, ứng dụng, cơ sở dữ liệu — xem Làm việc bên trong workspace của bạn.

Nếu bạn đang cài ArchiBot trong local VS Code hoặc mở extension mà không có thư mục, hãy bắt đầu với Sử dụng extension ArchiBot VS Code để biết công cụ nào cần một workspace được quản lý.

Khởi động bot

Bạn có hai cách để bắt đầu:

• Terminal. Mở terminal trong code-server (Terminal → New Terminal) và chạy archibot start. Lệnh này sẽ khởi tạo một phiên được quản lý — về mặt kỹ thuật, đó là một Codex CLI được quản lý đã được tinh chỉnh cho Archibus.
• Bảng trong trình soạn thảo. Mở bảng ArchiBot từ thanh bên của trình soạn thảo và nhập vào ô tin nhắn của nó — không cần terminal. Start ArchiBot trong bảng sẽ bắt đầu một phiên.

Bạn không cần đăng nhập. Workspace đã giữ sẵn một key được quản lý, nên bot sẵn sàng ngay khi workspace sẵn sàng. Nếu không tìm thấy archibot, mẫu workspace của bạn có thể không bao gồm ArchiBot được quản lý — hãy kiểm tra với quản trị viên tài khoản của bạn.

Chat từ bảng trong trình soạn thảo

Bạn muốn ở lại trong trình soạn thảo thay vì terminal? Mở bảng ArchiBot từ thanh bên và dùng ô tin nhắn ở phía dưới. Bảng có các chế độ Chat, Agent, và Full Access: dùng Chat cho các câu hỏi về tệp hoặc dự án bạn đang làm, Agent để cho ArchiBot thực hiện thay đổi trong workspace của bạn, và Full Access để cấp cho nó phạm vi thao tác rộng hơn trên workspace. Nó giao tiếp với cùng bot được quản lý, với cùng năng lực Archibus, như trong terminal — hãy chọn cách phù hợp nhất với tình huống.

Nó biết gì và có thể làm gì

ArchiBot được thiết lập như một trợ lý dành cho nhà phát triển Archibus và WebCentral. Ngay khi dùng, nó có thể:

• Làm việc với các chế độ xem AXVW — tạo khung cho một chế độ xem mới, giải thích một chế độ xem hiện có, và xác thực nó theo các quy tắc Archibus, báo cáo cụ thể những lỗi cần sửa.
• Đọc cơ sở dữ liệu một cách an toàn — chạy các truy vấn kiểu SELECT trên cơ sở dữ liệu của workspace để kiểm tra schema, xem các dòng mẫu, hoặc xác nhận một datasource. Kết quả bị giới hạn theo số dòng và tuân theo các hạn chế của view.
• Tạo datasource, workflow rule và form — và kiểm tra chúng theo các quy ước của Archibus trước khi bạn nối chúng vào.
• Tra cứu thông tin — tìm kiếm tài liệu tham chiếu Archibus và trợ giúp sản phẩm đi kèm thay vì đoán.
• Xem ứng dụng đang chạy — mở ứng dụng trực tiếp trong trình duyệt headless để xác nhận một view hiển thị hay để tái hiện sự cố.
• Xử lý các việc build và run — đọc log, khởi động lại Tomcat, và đi qua các bước triển khai hoặc di chuyển.

Nó điều phối công việc qua một thư viện lớn các skill Archibus (space, assets, leases, moves, projects, reports, security, và nhiều hơn nữa), nên thường sẽ theo các mẫu mà nhóm của bạn đã quen dùng.

Nó sẽ không làm gì

• Nó sẽ không thay đổi cơ sở dữ liệu. Công cụ truy vấn của nó chỉ đọc — không có UPDATE, INSERT, hay DELETE. Việc thay đổi schema và dữ liệu vẫn phải đi qua các migration và quy trình review thông thường của bạn.
• Nó sẽ không làm lộ bí mật. Các key của nhà cung cấp được che mờ và khả năng đọc thô thông tin xác thực đã bị tắt, đồng thời nó được chỉ thị không đưa token, key, hay dữ liệu khách hàng thô vào tệp, ghi chú, hoặc bất cứ thứ gì nó lưu. Hãy tự giữ mình theo cùng chuẩn đó.
• Nó thao tác trên các tệp workspace của bạn — hãy review các chỉnh sửa của nó như bạn sẽ review chỉnh sửa của một đồng đội trước khi commit.

Mẫu prompt

Các prompt cụ thể để thử. Hãy thật rõ ràng và chỉ đích danh tệp hoặc bảng bạn muốn; bạn càng chính xác, kết quả càng tốt.

Tạo một chế độ xem AXVW

“Tạo một view AXVW liệt kê các phòng cho tòa nhà đã chọn, có bộ lọc tòa nhà và các cột tên phòng, diện tích, và hạng mục. Xác thực nó và sửa mọi vấn đề trước khi hoàn tất.”

Xác thực và sửa một view hiện có

“Xác thực schema/ab-products/.../my-view.axvw và hướng dẫn tôi sửa từng lỗi bạn tìm thấy.”

Kiểm tra dữ liệu trước khi bạn xây dựng

“Cho tôi xem các cột trong bảng rm, rồi trả về 20 phòng mẫu kèm tòa nhà và tầng của chúng.”

Thêm một workflow rule

“Thêm một workflow rule gửi email cho người quản lý không gian khi hạng mục phòng thay đổi, và cho tôi biết rule đó được đăng ký ở đâu.”

Làm việc trên một form

“Trên form này, thêm một trường tài liệu cho bản vẽ mặt bằng và xác thực các điều khiển của form.”

Truy vết một datasource

“Tìm datasource phía sau panel này và thêm một điều kiện lọc để nó chỉ hiển thị các bản ghi đang hoạt động.”

Tìm hiểu vì sao một thay đổi không hiển thị

“Thay đổi view của tôi không xuất hiện trong ứng dụng. Kiểm tra log Tomcat, cho tôi biết lỗi là gì, và khởi động lại Tomcat nếu đó là cách sửa.”

Xác nhận nó hiển thị

“Mở danh sách phòng mới trong trình duyệt và xác nhận nó tải mà không có lỗi.”

Tra cứu một điều gì đó

“Archibus xử lý nhiều loại tiền tệ trên hồ sơ hợp đồng thuê như thế nào? Trích dẫn tài liệu tham khảo.”

Gửi để review

“Tóm tắt các thay đổi tôi đã thực hiện, rồi gửi chúng để CI review.”

Lệnh cuối cùng đó dùng archibot-submit-review, lệnh này đóng gói các thay đổi của bạn cho luồng Console CI Review — xem Môi trường tồn tại lâu dài và CI Review.

Các lần xác thực và tra cứu cơ sở dữ liệu chạy qua các công cụ Archibus tích hợp sẵn của ArchiBot — ở đây nó đang xác thực một view AXVW:

Khi bạn yêu cầu nó thay đổi điều gì đó, ArchiBot sẽ chỉnh sửa các tệp tại chỗ và thay đổi sẽ xuất hiện trong Source Control, sẵn sàng để bạn review như bất kỳ chỉnh sửa nào khác.

Giữ phiên của bạn

Một cuộc trò chuyện được gắn với runtime của workspace. Liệt kê các phiên trước đó bằng archibot sessions list và mở lại một phiên bằng archibot start --session <name>; archibot start một mình sẽ bắt đầu một cuộc trò chuyện mới. Một phiên không tồn tại qua thao tác stop/start hoặc rebuild của workspace, vì vậy khi bot tạo ra thứ gì đó bạn quan tâm — một bản tóm tắt, một kế hoạch, một tệp được tạo — hãy lưu nó: commit vào git, hoặc sao chép vào Shared Drive. Đừng trông chờ việc cuộn ngược lại terminal sau khi khởi động lại, vì nó sẽ bị xóa.

Workspace bot so với Console chat

ArchiBot cũng tồn tại dưới dạng chat trên trình duyệt trong Console (Sử dụng ArchiBot Chat). Chúng chia sẻ cùng skill và kiến thức Archibus, nhưng hoạt động ở những nơi khác nhau:

• Workspace bot có quyền thao tác trực tiếp trên workspace của bạn — nó đọc tệp của bạn, chạy truy vấn trên cơ sở dữ liệu, khởi động lại ứng dụng, và chỉnh sửa mã tại chỗ.
• Console chat dựa trên trình duyệt và phù hợp cho các câu hỏi, lập kế hoạch, và tra cứu tham chiếu khi bạn không ở trong workspace.

Hãy dùng một trong hai cho một nhiệm vụ cụ thể. Chạy cả hai trên cùng một việc chỉ làm tốn credit hai lần.

Các lệnh khác

• archibot status và archibot doctor — kiểm tra phiên được quản lý và các công cụ của nó có đang hoạt động tốt hay không.
• archibot capabilities — liệt kê những gì bot được quản lý có thể làm trong workspace này.
• archibot skills list — xem các skill Archibus mà nó có sẵn.
• archibot versions — hiển thị các phiên bản công cụ và image được quản lý đang dùng.
• archibot feedback — gửi phản hồi đã được làm sạch đến nhóm nền tảng.
• archibot-v2, archibot-cc, và cursor-agent — các trợ lý kiểu Cursor và kiểu Claude được quản lý, nếu bạn thích các giao diện đó hơn. Chúng dùng cùng quyền truy cập được quản lý.

Hướng dẫn liên quan

• Làm việc bên trong workspace của bạn — trình soạn thảo, ứng dụng, cơ sở dữ liệu, và log mà bot làm việc trên đó.
• Sử dụng extension ArchiBot VS Code — thiết lập extension có hoặc không có một workspace được quản lý.
• Sử dụng ArchiBot Chat — phiên bản chat trên trình duyệt và các nguồn ngữ cảnh của nó.
• Workspace ArchiBot và Shared Drive — nơi lưu những gì bot tạo ra.
• Môi trường tồn tại lâu dài và CI Review — điều gì xảy ra sau khi bạn gửi thay đổi để review.
• Khắc phục sự cố — các bước đầu tiên khi bot hoặc ứng dụng hoạt động không đúng.