QitOS 文档

面向智能体研究者的类 PyTorch 风格框架，用单一 AgentModule + Engine 内核构建可复现的 LLM 智能体。

QitOS 是面向智能体（agent）研究者的类 PyTorch 风格框架。你可以在同一个 AgentModule + Engine 内核上原型化方法、运行基准测试（benchmark），并用内建 qita 观察长时运行轨迹（trajectory）。

​

两种编写方式

QitOS 提供两种顶层的智能体编写方式：

• 研究优先（research-first）：手写提示词（prompt）、解析器（parser）、协议（protocol，模型输出的格式契约）、传输层（transport，与模型 API 通信的客户端）和工具面（tool surface），直接研究与优化内核（kernel，执行内核）。
• 预设优先（preset-first）：从家族预设（family preset，预配置的模型家族默认值）和预设工具构建器出发，快速得到稳定基线（baseline）与多模型切换能力。

这两种方式都是一等公民。

快速开始

2 分钟内跑起第一个智能体

构建第一个智能体

按步骤理解状态、工具、运行和追踪记录（trace）

教程课程

通过四节课程式教程学习 QitOS 的智能体设计方法

核心概念

理解 AgentModule、Engine、State、Tools 与追踪记录

API 参考

查看公开 Python API 与 CLI

研究优先路径

手写提示词、解析器、协议与工具面，直接理解内核。

预设优先路径

用家族预设在同一个示例里快速切换多个模型家族。

​

快速启动

1. 安装 QitOS

   pip install "qitos[models]"
   
2. 设置提供商配置

   export OPENAI_API_KEY="sk-..."
   export OPENAI_BASE_URL="https://api.siliconflow.cn/v1/"
   export QITOS_MODEL="Qwen/Qwen3-8B"
   
3. 运行最小编程智能体

   qit demo minimal
   
4. 用 qita 查看运行轨迹

   qita board --logdir runs
   

   打开 http://127.0.0.1:8765，查看追踪记录、回放（replay）和导出（export）结果。

​

QitOS 提供什么

智能体模式

开箱即用的 ReAct、PlanAct、Tree-of-Thought 和 Reflexion

课程式教程

从 ReAct 到代码安全审计智能体的完整进阶路径

可观测性

内置 qita 看板、回放与 HTML 导出

基准测试

在同一个内核上运行 GAIA、Tau-Bench 与 CyBench

Kit 工具箱

解析器、工具集、记忆、历史、规划器与评估器（critic）

​

特色设计

单一执行内核

示例、评测与生产型智能体全都运行在同一个 AgentModule + Engine 上

协议感知解析

提示词格式与解析器选择是显式设计，而不是隐藏的胶水层

长时运行上下文控制

HistoryPolicy、CompactHistory 与记忆适配器共同处理长时任务

以 qita 为核心的可追溯性

看板、回放与导出都建立在结构化追踪产物（artifact）之上