ThearchyHelios 3fd5d1309c 说法核对按复核调整(说法表 v1,还没有线上文档,不升版本)。来源和因果的口子:「主要由」不再吃掉「由于」(主要由(?!于),「主要源于」归来源类);原因按因果词的那一边认(「由于、因为、原因是、源于、得益于」后面,「导致、造成、引起、所致、是…的主要原因」前面、「由华东造成」在「由」和「造成」之间,「受…影响」中间),挂了拆解、原因点名的是它的段才按来源核,否则按因果核——「华东下降主要由于促销结束」「下降主要由促销结束造成」不再通过;没挂拆解的,原因不是目录里拆解的段时另报,认不出时照旧并进同一分句的来源判断;原因只是指代(「以上是下降的主要原因」)不核。来源类判断要点名拆解里的段:「主要来自」「集中在」「以…为主」看判断词后面,「主导」「贡献最大」看前面(同一分句没点名的往前找最近点了名的分句),拖累拉动带动照旧看整个分句;挂了拆解却没点名任何一段(「下降主要来自线上渠道」挂按地区的拆解、「主要来自新客流失」)判对不上,同一分句引用了判定语、比率拆解说「结构变化」「自身变化」的不用点名。误报去掉:来源、集中、分散、主导、拉动带动要这句话到这个分句为止说了变化才核(构成不核);建议、计划、预测、假设的分句不核(「建议」「下周」「避免」管到后面的分句);「异常」前面是订单、物流、支付、门店、营业、库存、设备、账号的是业务状态(后面跟着涨跌的照核),「异常的 + 名词」不核;「无异常」「未见异常」主语要是指标或波动;「来源于」不是「源于」;「表结构变化」不是结构变化;「相当」只认比几组、几样的,比上期的不核。漏报补上:「是…的主要原因」「主要原因是」、「近七成 / 超过一半 / 大部分的降幅来自」、「主要靠 / 在 / 体现在」、「以…为主」、「创」和「新高」之间 0–4 个字、「显著 + 涨跌」、「趋势向好」「波动较大」「三连降」「远高于往常」「异动」「一涨一跌」。写作规则补一句「写来源要点名是哪一段」,异常类的说法带上「显著上升或下降」。样本表 tests/test_analysis_claims_lexicon.py:复核的 70 句加这次看清楚的 26 句,每句期望的类或不核,以后改说法表都过这张表;和复核标记不一样的只有「退款主要集中在生鲜品类」(说的是构成,不核);绑定测试补上复核列的几个口子
2026-10-21 15:56:30 +08:00
说法核对按复核调整(说法表 v1,还没有线上文档,不升版本)。来源和因果的口子:「主要由」不再吃掉「由于」(主要由(?!于),「主要源于」归来源类);原因按因果词的那一边认(「由于、因为、原因是、源于、得益于」后面,「导致、造成、引起、所致、是…的主要原因」前面、「由华东造成」在「由」和「造成」之间,「受…影响」中间),挂了拆解、原因点名的是它的段才按来源核,否则按因果核——「华东下降主要由于促销结束」「下降主要由促销结束造成」不再通过;没挂拆解的,原因不是目录里拆解的段时另报,认不出时照旧并进同一分句的来源判断;原因只是指代(「以上是下降的主要原因」)不核。来源类判断要点名拆解里的段:「主要来自」「集中在」「以…为主」看判断词后面,「主导」「贡献最大」看前面(同一分句没点名的往前找最近点了名的分句),拖累拉动带动照旧看整个分句;挂了拆解却没点名任何一段(「下降主要来自线上渠道」挂按地区的拆解、「主要来自新客流失」)判对不上,同一分句引用了判定语、比率拆解说「结构变化」「自身变化」的不用点名。误报去掉:来源、集中、分散、主导、拉动带动要这句话到这个分句为止说了变化才核(构成不核);建议、计划、预测、假设的分句不核(「建议」「下周」「避免」管到后面的分句);「异常」前面是订单、物流、支付、门店、营业、库存、设备、账号的是业务状态(后面跟着涨跌的照核),「异常的 + 名词」不核;「无异常」「未见异常」主语要是指标或波动;「来源于」不是「源于」;「表结构变化」不是结构变化;「相当」只认比几组、几样的,比上期的不核。漏报补上:「是…的主要原因」「主要原因是」、「近七成 / 超过一半 / 大部分的降幅来自」、「主要靠 / 在 / 体现在」、「以…为主」、「创」和「新高」之间 0–4 个字、「显著 + 涨跌」、「趋势向好」「波动较大」「三连降」「远高于往常」「异动」「一涨一跌」。写作规则补一句「写来源要点名是哪一段」,异常类的说法带上「显著上升或下降」。样本表 tests/test_analysis_claims_lexicon.py:复核的 70 句加这次看清楚的 26 句,每句期望的类或不核,以后改说法表都过这张表;和复核标记不一样的只有「退款主要集中在生鲜品类」(说的是构成,不核);绑定测试补上复核列的几个口子
2026-10-21 15:56:30 +08:00

English | Simplified Chinese

AgentLab

A visual agent-orchestration workbench: define workflows on a canvas, watch execution node by node at run time, and put verifiable constraints on what comes out. Templates fix the skeleton, and agents are free only at the joints they are authorized for; the system fills the numbers in a report from snapshots, and every number opens to its provenance. The user interface is currently available in Simplified Chinese only.

Canvas during a run

The Research Assistant template running on Mock: finished nodes get a check mark, and running nodes show elapsed time and streaming output. The track along the bottom is a live timeline; the right column shows the run steps, driven by the same event stream.

Why use it

  • Numbers you can check: all arithmetic happens in SQL and in caliber cards (controlled metric sets), and the narrative layer has no right to create numbers. The report-writer node writes only citation markers, the system fills in the numbers from snapshots, and every number opens all the way to the cell in the query result it came from.
  • Constrained orchestration: the engine is compiled, so at run time the model can't change the graph structure; its freedom is confined to the inside of agent nodes and to branch decisions. Fully dynamic multi-agent collaboration stays in the exploration layer.
  • Pinned, reproducible versions: formal runs accept only published immutable versions (pinned by graph hash). The complete evidence of every execution goes into a content-addressed artifact store and is sealed, and one click verifies that nothing was altered.
  • Human control: approvals, joint sign-off, time limits, and Reject exits; nothing is ever approved automatically, and a process restart loses no state.
  • Honest issuance: the issuance contract decides between three tiers, formal / degraded / withheld; when data is missing, the output is downgraded rather than forced through.

Main features

Orchestration and runs

  • Canvas: 18 node types, drag and connect; live node highlighting, streaming output, and a timeline track at run time → Workflows
  • Copilot: generate or rewrite a whole graph from one sentence; it looks up schemas on demand and checks its work before delivering → Copilot
  • Human-in-the-loop: approvals, joint sign-off, time limits, Reject exits → Human nodes
  • Agent guardrails: repeated calls, spending, and context each have a guard; the step count is only a backstop → Guardrails
  • Runs and resuming: failed runs continue from the checkpoint; per-node duration, token usage, and cost → Runs
  • Publishing and evidence gates: published and governed levels, gates G1–G5, pre-publish check and fixes → Publishing and versions
  • Tools and the capability registry: built-in tools, custom tools, MCP, approval levels, registered endpoints → Tools
  • Knowledge base, memory, and skills: hybrid retrieval, memory across runs, reusable methodology → Knowledge base
  • Multi-model access: Anthropic, OpenAI, OpenAI-compatible services, and Mock → Model access
  • Code sandbox: two isolation tiers, the OS sandbox (Seatbelt / bubblewrap) or microVM → Code sandbox

Data

  • Ask Data: ask in natural language, and the system builds a graph, runs it, reviews it, and gives a conclusion → Ask Data
  • Data sources and spreadsheet import: read-only access to business databases, Excel / CSV turned into tables you can query with SQL, cross-database merges → Data sources
  • Data catalog: grain, business keys, valid-record conditions, code values, relationships; drafting, review, profiling, and a change log → Data catalog
  • SQL checks: the catalog catches seven kinds of queries that compute wrong numbers → SQL checks

Evidence and issuance

  • Clickable evidence: numbers, table and field names, and verbatim knowledge-base quotes all open to their provenance → Evidence and Issuance
  • Three-tier issuance: caliber cards plus issuance contracts, checked by value or by citation → Issuance contracts
  • Sealing and exports: one-click seal verification; self-contained report exports and verifiable reports → Exports
  • Review suite: double-blind recomputation, adversarial review, approval inquiry, the what-if sandbox, run comparison → Review suite

Quality

  • Regression evaluation: test suites, background evaluations, accuracy with intervals, comparisons and A/B, scheduled evaluations → Regression evaluation
  • Caliber ledger: each number in an answer gets a caliber label, with issuance by caliber, reconciliation, and recall → Caliber ledger

Apps and integration

  • Apps: entry forms, views, tasks, and actions derived from a published version → Apps
  • Writing to external systems: confirmation cards, idempotency keys, no automatic resend when the result is unknown → Write to external systems
  • External integration: inbound hooks, access keys, share links, embedding in portals → External integration
  • Schedules, event triggers, and notifications → Schedules and notifications

Operations and security

Quick start

You need conda (miniforge is enough), Node 20+, and pnpm; Docker isn't needed.

conda env create -f environment.yml   # first time: create the agentlab environment and install dependencies
./scripts/dev.sh                      # after that: one command starts the frontend and backend

Open http://localhost:5273 . You can try everything without an API key: the built-in Mock provider runs the whole orchestration path end to end; to connect a real model, see Model access. The 9 built-in templates run as they are.

Login is off by default: anyone on the same network who can open the page can use every feature. Turn on login before multiple people use it; see Login modes. For more startup options, see Development.

Deployment

  • Without Docker: ./scripts/prod.sh builds the frontend and has the backend serve the pages too; one process by default, at http://127.0.0.1:8000 .
  • Offline environments: build a Docker offline bundle with ./scripts/package-docker.sh, copy it to a machine that has only Docker Engine, and run ./deploy.sh.

See Deployment and deploy/README.md (written in Chinese). The app database defaults to SQLite with a single process; for multiple processes, switch to PostgreSQL (see PostgreSQL and Scaling). Read the Upgrade Notes before upgrading.

Documentation

Document What it covers
Using and building
Ask Data and Copilot What happens after you ask, output review, record retention, how Copilot builds graphs and looks things up
Workflows The canvas, node types, passing data, human nodes and rejection, agent guardrails, subworkflows, publishing and gates, runs and resuming
Evidence and Issuance Caliber cards, issuance contracts and tiers, citation markers, claim sentences, no data in the queried range, sealing and verification, report exports and verifiable reports, the review suite
Data Sources and Spreadsheet Import Connecting databases, read-only guarantees, uploading spreadsheets and recipes, accumulating by period, cross-database merges, masked columns
Data Catalog What the catalog records, drafting and review, export and import, data profiling, SQL checks, introspection scope for large databases, schema and value changes
Tools, MCP, and the Capability Registry Kinds of tools, approval levels, capability governance, limits on write capabilities, registered endpoints, network rules
Apps Creating apps, views and stamps, processes and tasks, writing to external systems, form submissions, personal apps, external integration
Evaluation and the Caliber Ledger Test suites and evaluation results, caliber labels per number, issuance by caliber, reconciliation, distilling, recall
Schedules, Event Triggers, and Notifications Schedules, event triggers, notification channels and email, subscribable events
Deployment and operations
Deployment prod.sh, the Docker offline bundle, the data directory, backups, upgrades
Configuration Model access, the public URL, environment variables, UI settings, the sandbox backend and microVM
PostgreSQL and Scaling Switching databases, importing, connection pools, PgBouncer, leases and takeover across processes, multiple machines, upgrades
Identity, Permissions, and Security Login modes, roles and the permission table, masking boundaries, audit, the code sandbox, security boundaries
Upgrade Notes How each update affects users and operators, and what to do when upgrading
Development
Architecture and Design Decisions The overall architecture, constrained dynamic orchestration, and the reasons behind key design decisions
Development Development environment, directory layout, dependencies and the lock file, tests, frontend checks, documentation checks
FAQ What to do about common errors and symptoms

Development and testing

Before running backend tests, remove model keys from the environment; otherwise the tests might really call the API:

cd backend && env -u ANTHROPIC_API_KEY -u ANTHROPIC_BASE_URL -u ANTHROPIC_AUTH_TOKEN -u OPENAI_API_KEY \
  python -m pytest -n auto
cd frontend && npx tsc -b
node scripts/check-all.mjs   # frontend checks; start ./scripts/dev.sh first

For tests on PostgreSQL, the 43 frontend checks, and the documentation checks, see Development.

License

This project is source-available and is licensed under the PolyForm Noncommercial License 1.0.0.

Noncommercial Use

You may use, study, modify, experiment with, and develop upon this software for purposes permitted under the PolyForm Noncommercial License 1.0.0.

Typical permitted noncommercial uses include:

  • personal research;
  • learning and education;
  • experimentation;
  • evaluation and testing;
  • hobby projects;
  • noncommercial software development.

See the LICENSE file for the applicable license terms.

Commercial Use

Commercial use is not permitted without prior written authorization from Yilun JIANG.

If you intend to use this software in a commercial product, commercial service, SaaS offering, customer project, commercial deployment, or other commercial context, you must obtain a separate commercial license before doing so.

For commercial licensing, see COMMERCIAL-LICENSE.md or contact:

Yilun JIANG me@thearchyhelios.com

Copyright (c) 2026 Yilun JIANG.

All rights reserved except as expressly granted under the applicable license.

S
Description
No description provided
Readme 35 MiB
Languages
Python 65.3%
TypeScript 19.8%
JavaScript 14.2%
CSS 0.3%
Shell 0.3%