Agently 文档

中文

EN

中文

EN

Appearance

能力升级地图 ​

这个页面不是 API 目录，而是帮助你判断：当前问题应该停留在哪一层解决。

适合什么时候读 ​

  • 你刚接触 Agently，不知道应该先学哪块
  • 你已经能跑通一次请求，但不确定何时需要工具、知识库或 TriggerFlow
  • 你想把团队开发路径统一成一条更稳定的升级路线

你会学到什么 ​

  • 单次请求、扩展能力、工作流编排分别解决什么问题
  • 什么时候应该留在请求层，什么时候该升级
  • 如何把官方 Agently Skills 的能力边界翻译成开发者能直接使用的学习路径

能力升级地图 ​

1. 单次请求 ​

先学会这条最短链路：

模型设置 -> input() -> output() -> start()

适合场景：

  • 结构化抽取
  • 摘要、分类、打标
  • 单轮问答

先读：

2. 高质量请求 ​

当你开始关心“字段稳不稳”“结果怎么复用”“流式怎么接 UI”时，问题还在请求层，只是质量要求提高了。

适合场景：

  • 稳定机读输出
  • 字段依赖
  • 结构化流式输出
  • 一次请求多路消费 text/data/meta

继续读：

3. 扩展能力 ​

当模型需要访问外部世界，或你的服务需要更像一个应用系统，而不只是一次模型调用时，再引入扩展能力。

适合场景：

  • 搜索、浏览、命令执行
  • MCP Server
  • 知识库 / RAG
  • Web 服务暴露

继续读：

4. 工作流编排 ​

只有当控制流本身成为核心问题时，才升级到 TriggerFlow。

典型信号：

  • 有明确阶段和状态
  • 有分支、并发、等待、恢复
  • 你需要 runtime stream、execution save/load 或外部事件驱动

继续读：

5. 迁移与高级场景 ​

适合已经有现有系统、要做架构迁移或框架扩展的团队。

继续读：

常见误区 ​

  • 一开始就上 TriggerFlow，结果问题其实只是输出结构不稳定。
  • 明明只是请求层问题，却先写了自定义 parser、重试循环和胶水代码。
  • 把 Tools、Session、KB 当成顶层架构，而不是请求层的支持能力。

下一步去哪 ​

相关案例 ​

  • agently-playbook
  • agently-model-setup
  • agently-output-control
  • agently-triggerflow