DashScope AgenticX¶
企业级 AI 专家,为行动而生。 AgenticX 是一个用于构建和运行领域专家的 Python Agent 运行时。它通过统一的运行时将模型、工具、技能、权限与持久化 会话连接起来,并提供终端界面以及面向嵌入式应用的 API。
你可以直接把它当作本地助手使用,嵌入到 Python 应用中,或将领域专家打包为 带版本的 App Bundle。DashScope SDK Expert 与 Bailian Expert 是内置的专家 模板,展示了这一应用层的用法。
特性¶
-
统一运行时
工具、技能、Hook 与会话状态归实例所有;通过
RuntimeBuilder共享构建流程。 -
终端与 TUI
功能完整的交互式 CLI,提供 40+ 条斜杠命令,另有可选的 Textual TUI,支持丰富的 Markdown 输出。
-
可嵌入 SDK
run_once、run_stream与带类型的run_events,适用于脚本、CI、 IDE 插件和应用。 -
工具与技能
文件系统、Shell、Web、浏览器、摄像头、MCP 服务、Markdown 技能,以及声明式 TOML 扩展 — 无需编写代码。
-
受治理的执行
权限分级、策略文件、操作系统沙箱后端、审计日志、隐私模式 与事件 Hook。
-
应用与专家
带版本的 App 清单,支持校验和验证与权限差异对比;一条命令 即可初始化专家工作区。
环境要求¶
- Python 3.10+(基于 Pillow 的
vision/media扩展需要 3.11+)。 - 所用 Provider 的模型 API Key — 对于默认的 Tongyi/DashScope Provider:
export DASHSCOPE_API_KEY="<your-api-key>"
安装¶
python -m pip install "dashscope-agenticx[tui]"
agenticx --version
如需最小化的非 TUI 安装,使用 pip install dashscope-agenticx 并通过
agenticx --cli 启动。可选扩展(Provider SDK、web、browser、media)
见快速开始。
示例¶
在终端中运行¶
agenticx # interactive session
agenticx -c "Summarize this project" # one-shot, then exit
在 Python 中运行¶
from dashscope_agenticx.sdk import run_once_sync
reply = run_once_sync("Inspect this project's structure without changing files")
print(reply)
消费带类型的事件¶
import asyncio
from dashscope_agenticx.sdk import run_events
async def main():
async for event in run_events("Summarize the project"):
print(event.type.value, event.payload)
asyncio.run(main())
一次性运行会执行工具,而不仅仅是生成文本 — 请在合适的工作区中启动, 并为任务选择恰当的权限。
下一步¶
AgenticX 不是托管服务、不是加固的操作系统沙箱,也不是完整的工作流平台。 语音、摄像头、浏览器、Web 搜索、调度器与实验性功能均为可选项, 并非核心运行时的前置条件。