Cho trợ lý AIhttps://lotics.ai/tai-lieu/cli.md

Lotics CLI

Giao diện dòng lệnh cho trợ lý AI tương tác với Lotics – hệ thống lưu trữ với dữ liệu có cấu trúc, tạo chứng từ, tự động hóa quy trình và giao diện web tích hợp.

Thông qua CLI này, trợ lý của bạn có thể:

  • Bảng & Bản ghi – Tạo bảng với trường có kiểu dữ liệu (văn bản, số, ngày, chọn, liên kết bản ghi, công thức, file). Ghi, truy vấn, cập nhật và tổng hợp bản ghi. Người dùng xem và chỉnh sửa cùng dữ liệu trong giao diện web dạng bảng tính với chế độ xem, bộ lọc và sắp xếp.
  • Tạo chứng từ – Mẫu Excel, Word và PDF với biến. Gọi generate_document với dữ liệu và nhận tệp đã điền.
  • Tự động hóa – Quy trình hướng sự kiện: khi bản ghi được tạo, khi trường thay đổi, theo lịch. Chuỗi các bước: cập nhật bản ghi, gửi email, gọi webhook, chạy AI. Thiết lập qua CLI – chúng chạy mà không cần trợ lý trực tuyến.
  • File – Tải lên, đính kèm vào bản ghi, tải xuống. PDF, hình ảnh, bảng tính.
  • Ứng dụng – Xây dựng giao diện dữ liệu chuyên biệt với chế độ xem, bộ lọc và hành động được cấu hình. Không cần code frontend.
  • Kiến thức – Tài liệu tham khảo dài mà trợ lý có thể tìm kiếm và đọc.
  • Quản trị – Thành viên, nhóm, quyền hạn dựa trên vai trò, nhật ký kiểm tra.

Năm phút, từ con số không

Cài CLI — một lệnh, không cần gì thêm:

curl -fsSL https://lotics.ai/install.sh | bash

Sau đó thêm một lệnh nữa là xong: nó tạo tài khoản, áp mô hình của bạn vào không gian làm việc — các bảng, các dòng đầu tiên và các ứng dụng — rồi in ra một liên kết đăng nhập dùng một lần:

lotics setup model.json --email ban@congty.com

Thêm --json thì nó in ra đúng một đối tượng thay vì tiến trình — tổ chức, không gian làm việc, mã các ứng dụng và liên kết đăng nhập — đây là dạng bạn cần khi người đọc kết quả là một trợ lý chứ không phải con người.

Hoặc để trợ lý tự tìm hiểu rồi dựng

Dán đúng một dòng này vào trợ lý lập trình của bạn — Claude Code, Cursor, Codex, hay bất kỳ công cụ nào bạn dùng. Chép dòng đó từ mục thiết lập; trợ lý tự đọc phần hướng dẫn. Rồi nó hỏi bạn quản lý cái gì, đọc mô hình mẫu của ngành bạn nếu có, dựng mô hình bảng riêng từ chính lời bạn kể, và kết thúc ở trình duyệt mà bạn đã đăng nhập sẵn.

Thiết lập Lotics cho tôi: đọc https://lotics.ai/tai-lieu/prompt.md rồi làm theo.

Mọi bước của đường dựng mô hình trước lúc đăng ký đều chạy được khi chưa có tài khoản, nên mô hình được viết và kiểm xong trước khi có bất cứ thứ gì được tạo ra. --email chỉ dùng để tạo một tài khoản hoàn toàn mới: nếu bạn đã đăng nhập thì lệnh sẽ từ chối chứ không âm thầm tạo thêm tài khoản thứ hai, còn chạy lại auth signup với địa chỉ máy này đã lưu thì lệnh báo cho bạn biết thay vì báo lỗi.

Những gì bạn nhận được là của bạn: bảng bình thường và ứng dụng bình thường, chạy ngay trong không gian làm việc của bạn — trợ lý của bạn sửa tiếp từ đó, và bạn cũng sửa được. lotics model pull ghi ra mô hình của không gian làm việc, gồm cả các ứng dụng, để trợ lý của bạn sửa rồi áp lại, còn lotics docs building_an_app là trình tự cho mọi việc sau đó.

Cài đặt

Trên macOS, Linux và WSL:

curl -fsSL https://lotics.ai/install.sh | bash

Trên Windows, mở PowerShell rồi chạy:

irm https://lotics.ai/install.ps1 | iex

Cả hai đều tải về đúng một tệp chạy đã biên dịch sẵn và đối chiếu với mã kiểm tra đã công bố. Không dính đến Node.js, npm hay bất kỳ trình quản lý gói nào, không cài gì ở phạm vi toàn hệ thống, và xoá tệp đó là gỡ sạch.

Chạy trong môi trường sandbox của một trợ lý AI, hoặc sau proxy của công ty? Cần mở cho ba tên miền, và đó là ba bước khác nhau: lotics.ai phục vụ trình cài đặt, downloads.lotics.ai phục vụ tệp chạy mà nó tải về, còn api.lotics.ai là nơi CLI làm việc sau đó. Chỉ mở tên miền đầu thì tải được nửa chừng rồi dừng. Ba tên miền đó đủ cho cả việc áp một mô hình, vì các ứng dụng của nó được dựng và triển khai bên Lotics — chỉ một ứng dụng viết mã mà bạn tự dựng trên máy này mới cần thêm registry.npmjs.org.

Kiểm tra đã cài được chưa — lệnh này in ra số phiên bản:

lotics --version

lotics upgrade cập nhật ngay tại chỗ — lệnh này tự chạy đúng trình cài đặt mà bản CLI này đến từ đó, nên bạn không cần nhớ. Chạy thẳng lệnh cài đặt cũng cho kết quả như vậy, và cả hai đều không làm gì nếu bạn đang ở bản mới nhất. CLI sẽ báo khi có phiên bản mới.

Áp một mô hình cũng không cần thêm gì: Lotics triển khai mọi ứng dụng mô hình khai báo, và không có gì rơi xuống đĩa của bạn. Node 18+ chỉ cần cho một ứng dụng viết mã dựng trên máy này — lotics app create --custom, lotics app pull và lotics app deploy mới là chỗ cần nó. Mọi việc còn lại — đăng nhập, áp một mô hình, làm việc với bảng và chứng từ — chỉ cần tệp chạy đó là đủ.

Xác thực

Tạo tài khoản mới

lotics auth signup                                       # nhắc tương tác
lotics auth signup agent@co.com --name "My Agent"        # không tương tác

Cờ đăng ký:

  • --name <name> – tên hiển thị (mặc định là tiền tố email)
  • --timezone <tz> – múi giờ không gian làm việc (mặc định lấy theo múi giờ của máy này, ví dụ: Asia/Ho_Chi_Minh)

Đăng ký tạo tài khoản, tổ chức, không gian làm việc và khóa API trong một bước. Email magic link được gửi để bạn truy cập ứng dụng web — không cần mật khẩu.

Đăng nhập tài khoản đã có

lotics auth login you@co.com             # in ra một liên kết và một mã, rồi thoát
lotics auth login you@co.com --wait      # ở lại chờ tới khi bạn bấm Xác nhận
lotics auth login you@co.com --local     # ghim thư mục này vào tổ chức đó, và chờ

Dùng lệnh này trên máy mới, hoặc để thêm một tổ chức khác vào máy đã lưu khóa — tổ chức bạn chọn trên trang sẽ thành tổ chức đang hoạt động. Lệnh in ra một liên kết — cũng được gửi vào hộp thư của bạn — cùng một mã bốn ký tự, rồi thoát. Mở liên kết, đăng nhập, xem trang có hiện đúng mã đó không rồi bấm Xác nhận. Nếu trang báo yêu cầu này dành cho tài khoản khác, hãy đăng xuất ở đó rồi đăng nhập bằng email bạn đã đưa cho lệnh; sau đó chạy lệnh bạn đang cần và máy này tự lấy khóa về. Liên kết và mã chỉ dùng được trong mười lăm phút — quá hạn thì chạy lại lệnh để lấy cặp mới. Không phải đi tìm khóa trong phần Cài đặt, cũng không phải dán gì. lotics setup tự làm đúng việc này khi email bạn đưa cho nó đã có tài khoản.

Truy cập ứng dụng web

lotics auth web

Gửi email magic link đến địa chỉ email tài khoản của bạn. Nhấn vào link để truy cập ứng dụng web. Yêu cầu đã đăng ký hoặc thiết lập trước đó.

Sử dụng khóa API hiện có

lotics auth api-key                      # nhắc tương tác
lotics auth api-key ltk_...              # đăng ký tổ chức của khóa thành một hồ sơ

Khóa API được tạo trong ứng dụng web Lotics tại Cài đặt -> Khóa API. Một khóa thuộc về một tổ chức, nên lệnh này đăng ký tổ chức đó thành một hồ sơ có tên — chạy một lần cho mỗi tổ chức. Đăng ký thêm khóa sẽ thêm hồ sơ; không bao giờ ghi đè hồ sơ đã có.

Chuyển đổi giữa các tổ chức

Mỗi khóa đã lưu là một hồ sơ. Chuyển tổ chức hoạt động mà không cần dán lại khóa:

lotics org                          # liệt kê tổ chức đã lưu (đánh dấu tổ chức hoạt động)
lotics org use acme                 # chuyển tổ chức theo tên (hoặc ID tổ chức)

Để làm việc nhiều tổ chức cùng lúc, ghim một thư mục (ví dụ git worktree) vào tổ chức riêng để việc chuyển đổi ở nơi khác không ảnh hưởng — khóa vẫn lấy từ kho chung:

lotics org use acme --local         # ghi ./.lotics/config.json (con trỏ, không chứa khóa)
lotics workspace select wks_...     # lưu không gian vào ghim đó

Quản lý xác thực

lotics auth login <email>           # đăng nhập tài khoản đã có — mở liên kết, bấm Xác nhận
lotics auth web                     # gửi email magic link để truy cập ứng dụng web
lotics auth whoami                  # hiển thị tài khoản, tổ chức, không gian hoạt động và nguồn
lotics auth logout [<name|id>]      # xóa một hồ sơ (mặc định: tổ chức hoạt động), hoặc bỏ ghim thư mục
lotics auth logout --all            # xóa toàn bộ thông tin đăng nhập đã lưu

Khóa được lưu một lần cho mỗi tổ chức dưới dạng hồ sơ tại ~/.lotics/config.json. File .lotics/config.json của một thư mục là một ghim không chứa khóa — con trỏ tới tổ chức, khóa lấy từ kho chung. Cho CI hoặc dùng tạm thời, đặt LOTICS_API_KEY thay vì lưu file.

Thứ tự ưu tiên (cao nhất trước): cờ --api-key > biến môi trường LOTICS_API_KEY > biến môi trường LOTICS_ORG > file .lotics/config.json cục bộ > hồ sơ hoạt động chung. LOTICS_WORKSPACE (hoặc --workspace) ghi đè không gian làm việc.

Quy trình làm việc

1. lotics auth signup                   — tạo tài khoản hoặc xác thực
2. lotics workspace                    — liệt kê không gian (chọn nếu có nhiều)
3. lotics tools                        — liệt kê công cụ có sẵn theo danh mục
4. lotics tools <name>                 — hiển thị mô tả công cụ + schema đầu vào đầy đủ
5. lotics run <tool> '<json>'          — thực thi công cụ với tham số JSON

Luôn kiểm tra schema (bước 4) trước khi gọi công cụ. Công cụ truy vấn trả về ID (ID bảng, ID bản ghi, ID file) được dùng làm tham số cho công cụ khác.

Các lệnh

lotics tools                            Liệt kê tất cả công cụ có sẵn
lotics tools <name>                     Hiển thị mô tả và schema đầu vào của công cụ
lotics run <tool> '<json>'              Thực thi công cụ
lotics setup <model.json>               Lần đầu, một lệnh: tài khoản + không gian làm việc + liên kết đăng nhập
lotics model apply <model.json>         Áp mô hình vào đây: kiểm trước, rồi chỉ thêm, không xoá bảng nào
lotics model check <model.json>         Lần áp sẽ thay đổi những gì, không ghi gì cả
lotics model pull [-o <model.json>]     Mô hình của không gian làm việc này — bảng và ứng dụng
lotics docs                             Liệt kê tài liệu tham khảo mà CLI này mang theo
lotics docs model                       Tài liệu về tệp mô hình — chạy không cần mạng, không cần tài khoản
lotics docs <area>                      In một tài liệu, tối đa một trang (ví dụ: lotics docs model)
lotics docs <area>/<section>            Một mục, hoặc một dòng của tài liệu dạng bảng
lotics docs [<area>] --grep <text>      Tìm trong các tài liệu tham khảo trên máy chủ
lotics org                              Liệt kê tổ chức đã lưu (đánh dấu hoạt động)
lotics org use <name|id> [--local]      Chuyển tổ chức hoạt động (--local ghim thư mục này)
lotics workspace                        Liệt kê không gian trong tổ chức hoạt động (đánh dấu hiện tại)
lotics workspace select <id>            Chuyển không gian hoạt động
lotics workspace create <name>          Tạo không gian mới (chỉ admin)
lotics workspace settings               Đổi tên, tiền tệ hay múi giờ của không gian (chỉ admin)
lotics app <subcommand>                 Tạo ứng dụng viết mã, rồi dựng và triển khai nó
lotics knowledge <subcommand>           Tạo, đọc, gắn nhãn và cập nhật tài liệu tham khảo
lotics file upload <file|dir...>        Tải file lên (bí danh: lotics upload)
lotics file download <file_id>          Tải file xuống theo ID (bí danh: lotics download)
lotics file list                        Kho file có gì, mới nhất trước — mỗi lần một trang
lotics file delete <file_id>            Bỏ một file; bị từ chối khi vẫn còn nơi dùng đến nó
lotics report '<json>'                  Cho chúng tôi biết điều gì đang cản trở bạn

lotics --help in đầy đủ danh sách này kèm mọi lệnh con và cờ, do chính bản CLI bạn đang cài in ra — nên nó không bao giờ lạc hậu so với bản đó.

Tài liệu tham khảo, khớp với phiên bản bạn dùng

Trang này mô tả CLI dùng để làm gì. Còn hợp đồng chính xác nằm bên trong chính CLI, và lotics docs in ra nó:

lotics docs                     # các tài liệu mà CLI này mang theo
lotics docs model               # một tài liệu
lotics docs model/apps          # một mục, hoặc một dòng của tài liệu dạng bảng

Mỗi lần in ra nhiều nhất một trang. Tài liệu dài hơn thế sẽ in phần mở đầu cùng các địa chỉ dẫn vào bên trong, nên lệnh kế tiếp luôn nhỏ hơn lệnh trước.

Một trang mới hơn bản CLI của bạn — trang mà một thông báo lỗi từ Lotics nhắc tới — được đọc từ Lotics, và việc tìm kiếm cũng vậy:

lotics docs --grep currency          # mọi tài liệu nhắc tới nó
lotics docs model --grep currency    # trong một tài liệu

Thông báo lỗi luôn ghi trang theo cách bản CLI của bạn mở được: lotics docs <path>, hoặc với bản CLI cũ hơn là lotics run docs '{"path":"<path>"}'.

Trang này chỉ có một bản duy nhất và không mang phiên bản — điều đó đúng cho việc mô tả sản phẩm nhưng sai cho việc mô tả hợp đồng: dự án của bạn ghim một phiên bản, còn một bản sao đặt trên web sẽ trả lời thay cho phiên bản khác.

Tài liệu SDK của một ứng dụng viết mã nằm trong gói @lotics/app-sdk, ở node_modules/@lotics/app-sdk/AGENTS.md trong thư mục ứng dụng.

Xây dựng ứng dụng

Một ứng dụng thuộc một trong hai loại. Ứng dụng JSON được khai trong mục apps của tệp mô hình và được lotics model apply dựng ngay bên Lotics. Ứng dụng viết mã là một dự án Vite + React + TypeScript dựng trên máy bạn: lotics app create <tên> --custom tạo khung trên @lotics/app-sdk, còn lotics app deploy dựng rồi đưa nó lên. lotics app pull cập nhật dự án theo phiên bản đang chạy sau khi người khác vừa đưa một bản lên, còn lotics app pull <app_id> <thư mục> tải nó về một thư mục mới trên máy khác. Một dự án có chỗ sửa của riêng bạn không bao giờ bị ghi đè: lệnh pull liệt kê các tệp bạn đã đổi.

Những gì một ứng dụng đọc và làm được khai ngay trên ứng dụng, có hiệu lực liền: lotics run set_app_queries, set_app_workflow và set_app_agent mỗi lệnh tạo một phiên bản mới của ứng dụng, mỗi lần áp mô hình hay triển khai cũng vậy. lotics run query_app_versions liệt kê các phiên bản, còn lotics run rollback_app đưa ứng dụng về một phiên bản trước — các bảng và những bản ghi ứng dụng đã ghi trong lúc đó vẫn giữ nguyên.

Bắt đầu từ lotics docs building_an_app — tài liệu này trình bày trình tự và lý do của trình tự đó.

Dựng không gian làm việc từ một mô hình

Các bảng được mô tả trong một tệp rồi tạo ra từ tệp đó. lotics docs model in ra tài liệu về tệp mô hình — chạy được khi không có mạng và khi chưa có tài khoản nào.

Sau đó lotics setup model.json --email ban@congty.com kiểm tệp, tạo tài khoản, tổ chức, không gian làm việc và khoá API, rồi áp mô hình vào đó.

Về sau lotics model apply model.json chạy lại nó vào không gian làm việc hiện tại. Lệnh kiểm cả tệp trước và báo mọi chỗ sai một lượt; rồi tạo phần mới, nhận lấy bảng nào đã mang đúng tên đó, và không bao giờ đổi tên thứ gì hay xoá một bảng, một trường, một lựa chọn hay một ứng dụng — nên chạy lần thứ hai không thay đổi gì, còn mô hình có thêm bảng thì bảng mới được thêm vào. Khi tệp đã được kéo về hay đã áp vào không gian làm việc này, lần áp chỉ gửi những gì tệp đã đổi kể từ lần đó, nên thứ đã đổi trong không gian làm việc mà tệp không đụng tới vẫn giữ nguyên. Thứ tệp bỏ bớt sẽ mất ở chỗ lần áp ghi lại đúng như tệp nêu — các mục acts, các cột của một ứng dụng, một mục write_rules, giá trị mặc định của một trường — còn ở chỗ lần áp để nguyên như cũ thì bị từ chối: một bảng, một trường, một lựa chọn hay một ứng dụng, kèm tên công cụ xoá được nó, hoặc một thiết lập như quy tắc đọc hàng của một bảng. Tệp đổi chỗ một mục trong acts của một ứng dụng thì chỉ gửi đúng việc đổi chỗ đó; các trường và lựa chọn của một bảng vẫn giữ thứ tự mà không gian làm việc đang có, và lần áp nói rõ điều đó. Một thay đổi chỉ nằm trong một ứng dụng — các cột, các phần, các mục acts của nó — để nguyên các bảng và chỉ dựng lại ứng dụng đó, cùng ứng dụng khác đọc tới chỗ vừa đổi. Trước khi ghi bất cứ thứ gì, lần áp còn từ chối một ứng dụng thiếu cách trình bày mà bảng của nó cần tới (lotics docs design), cho đến khi ứng dụng nhận bản vá mà lời từ chối in ra, hoặc ghi rõ lý do không nhận dưới khoá declines mà lời từ chối nêu. lotics model check model.json cho biết lần áp sẽ thay đổi những gì, in ra các bản vá đó, và không ghi gì cả — khoá chỉ có quyền đọc cũng chạy được (schema:read, thêm data:read khi tệp khai báo ứng dụng hoặc được gửi dưới dạng phần thay đổi). lotics model pull -o model.json ghi ra mô hình mà không gian làm việc đang giữ, để tệp được kéo về đúng thứ đang dùng trước khi ai đó dựng tiếp lên nó.

Đổi tên là việc riêng: lotics run update_table đổi tên một bảng hay một trường, và lần model pull kế tiếp mang theo nhãn mới.

Preset

Một preset là một model.json mẫu hoàn chỉnh của một ngành. Danh sách nằm ở https://lotics.ai/presets/index.json, mỗi mô hình ở https://lotics.ai/presets/<mã ngắn>.json; trợ lý của bạn đọc mô hình gần nhất làm ví dụ mẫu rồi viết mô hình của riêng bạn, bằng chính lời của bạn. Không có gì được cài vào, và thứ bạn nhận được là mô hình bạn sở hữu ngay từ phút đầu.

Báo cho chúng tôi điều gì đang cản trở

lotics report là kênh dành cho những thứ không có gì khác ghi nhận được: một khả năng chưa tồn tại, một lệnh chạy thành công nhưng làm sai việc, một thông báo lỗi không nói được cách khắc phục. Nó nhận một khung ngắn thay vì một đoạn văn — bạn đang định làm gì, và điều gì đã xảy ra — bởi vì điều bạn đang định làm là thứ duy nhất không nhật ký nào dựng lại được. Chạy lệnh không kèm tham số để xem khung đó.

Danh mục công cụ

Danh mục Bao gồm
Bảng Truy vấn, tạo, cập nhật, xóa, sao chép bảng. Thêm trường với kiểu dữ liệu (văn bản, số, ngày, chọn, bản ghi liên kết, công thức). Thêm xác nhận
Bản ghi Truy vấn với bộ lọc, tạo, cập nhật, xóa bản ghi. Tổng hợp (đếm, tổng, trung bình). Khóa/mở khóa. Khôi phục đã xóa
Chế độ xem Góc nhìn đã lưu: bộ lọc, sắp xếp, hiển thị trường, quy tắc màu
File Xóa một file không còn nơi nào dùng đến — tải lên, tải xuống và liệt kê là các lệnh lotics file
Mẫu Liệt kê, kiểm tra và xóa mẫu mọi loại (Excel, Word, PDF)
Mẫu Excel Tạo mẫu Excel với ký hiệu biến đặt trong ô, chèn dữ liệu, tạo file .xlsx đã điền
Mẫu Word Tạo mẫu Word với biến, vòng lặp ({%for%}), điều kiện. Tạo file .docx đã điền
Mẫu PDF Tạo mẫu HTML/CSS hoặc PDF có thể điền. Tạo PDF đã điền. Phân tích cấu trúc PDF
Tự động hóa Tạo quy trình hướng sự kiện: kích hoạt (bản ghi được tạo, trường thay đổi, lịch, webhook) + bước (cập nhật bản ghi, gửi email, hành động AI)
Ứng dụng Tạo giao diện dữ liệu chuyên biệt với chế độ xem và nút hành động được cấu hình
Kiến thức Tạo, cập nhật, tìm kiếm và đọc tài liệu tham khảo cho ngữ cảnh không gian làm việc
Quản trị Truy vấn thành viên, nhóm, nhật ký kiểm tra

Cờ

Cờ Mô tả
--json Xuất JSON đầy đủ (mặc định là văn bản dễ đọc)
--timeout <ms> Thời gian chờ thực thi công cụ (mặc định: 60000)
-o <path> Với download là thư mục để lưu vào. Với model pull và knowledge get là file để ghi ra
--as <name> Ghi đè tên file khi tải lên
--api-key <key> Khóa API (ghi đè cấu hình đã lưu và biến môi trường LOTICS_API_KEY)
--workspace <id> Ghi đè không gian làm việc cho một lệnh (bí danh: -w)
--version Hiển thị phiên bản CLI

Đầu ra

Thông báo trạng thái (xác thực, xác nhận tải xuống, lỗi) xuất ra stderr. Đầu ra công cụ xuất ra stdout. Điều này cho phép piping sạch:

lotics run query_records '{"table_id":"tbl_..."}' --json | jq '.records[].name'

Lỗi in ra stderr và thoát với mã 1.

File

Một số công cụ tạo file và trả về { file_id, url, filename }. Tải xuống bằng:

lotics run generate_document '{"..."}' --json
lotics download <file_id> ./bao_cao.xlsx     # file cần ghi ra
lotics download <file_id> -o ./output/       # thư mục cần lưu vào, giữ tên đã lưu trên hệ thống

Đường dẫn đứng sau là file, -o là thư mục — đúng cách cp và curl -o phân biệt. Chỉ nêu một trong hai, không nêu cả hai. Đường dẫn đã ghi xuất ra stdout, nên có thể nối thẳng lệnh tải xuống vào lệnh mở file kế tiếp.

Tải file lên trước khi tham chiếu trong tham số công cụ:

lotics upload ./data.csv ./report.pdf ./documents/
lotics run create_records '{"table_id":"tbl_...","records":[{"fld_file":["fil_..."]}]}'

Stdin và tệp

Pipe tham số JSON qua stdin thay vì inline, hoặc truyền một tệp với dấu @ ở đầu. Dấu - ở cuối là cách xin đọc stdin — không có nó thì lệnh chạy công cụ với tham số rỗng và trả lời ngay, đúng như một công cụ không cần tham số nên làm:

echo '{"table_id":"tbl_..."}' | lotics run query_records -
lotics run query_records @args.json

Trong PowerShell, hãy dùng dạng tệp. Dấu nháy bên trong một tham số inline bị shell nuốt trước khi lotics nhận được, và CLI sẽ báo lại chuỗi JSON đã mất dấu nháy.

CI / không tương tác

export LOTICS_API_KEY=ltk_...
lotics run query_tables '{}'

# Hoặc nhắm tới tổ chức/không gian đã lưu mà không đổi tổ chức hoạt động:
LOTICS_ORG=acme LOTICS_WORKSPACE=wks_... lotics run query_tables '{}'

SDK (Node.js)

import { LoticsClient } from "@lotics/cli";
const client = new LoticsClient({ apiKey: "ltk_..." });

// Discover tools
const { categories } = await client.listTools();
const info = await client.getTool("query_records");

// Execute tools
const { result } = await client.execute("query_tables", {});

// File operations
const upload = await client.uploadFiles(["./report.pdf", "./data.csv"]);
await client.downloadFile(url, "./output.xlsx");
await client.downloadFileById(fileId, "./downloads/");

Một phiên làm việc trông như thế nào

Sau bước xác thực, mọi thứ đều lặp lại đúng ba động tác: xem schema, chạy công cụ, dùng các ID mà nó trả về.

# 1. Xác thực một lần — khóa được lưu theo từng tổ chức
lotics auth signup agent@company.com --name "Ops Agent"

# 2. Xem schema trước khi gọi. Lệnh này in ra schema của đúng phiên bản bạn đang
#    cài, sinh ra từ mã nguồn — đừng đoán tên tham số từ một trang như trang này.
lotics tools create_table

# 3. Tạo bảng. Thuộc tính của trường nằm PHẲNG ngay trên đối tượng trường.
lotics run create_table '{
  "name": "Invoices",
  "add_fields": [
    {"name": "Customer", "type": "text"},
    {"name": "Amount", "type": "number", "notation": {"style": "currency", "currency": "USD"}},
    {"name": "Status", "type": "select", "options": [{"name": "Draft"}, {"name": "Sent"}]},
    {"name": "Due Date", "type": "date"}
  ]
}'

# 4. Đọc lại các khóa vừa sinh — fld_… cho trường, opt_… cho lựa chọn
lotics run get_table '{"table_id": "tbl_..."}'

# 5. Ghi dữ liệu theo các khóa đó. Giá trị select luôn là mảng khóa lựa chọn.
lotics run create_records '{
  "table_id": "tbl_...",
  "records": [{"fld_...": "Acme Corp", "fld_...": ["opt_..."]}]
}'

Chứng từ, tự động hóa, ứng dụng và file đều đi theo vòng lặp này, chỉ đổi công cụ. Schema tham số được cố ý không chép lại vào trang này — lotics tools <name> in ra đúng schema của phiên bản bạn đã cài, còn một bản chép ở đây sẽ mô tả một phiên bản khác cho người đọc kế tiếp.

Đặt lịch demo

30 phút, hẹn giờ qua điện thoại hoặc Zalo.