常见问题

Ageniti 是 Agent 框架吗？

不是。Ageniti 不负责创建 Agent、planning loop、memory system 或 workflow orchestration engine。

Ageniti 帮助开发者构建给 Agent 使用的应用。

Ageniti 会自动把 React component 变成工具吗？

不会。你需要显式把选定应用能力定义成 action。

这是刻意设计。显式 contract 更容易审查，也能避免意外暴露 UI-only 或内部行为。

不用 React 可以用 Ageniti 吗？

可以。核心 action model 和 runtime 是 headless 的，可以在普通 Node.js 或 TypeScript 项目里使用。

React、Next.js 和 Expo 只是接入路径，不是 runtime 依赖。

Action 应该包含什么？

Action 应该包含一个边界清晰的应用能力、typed input、typed output、风险 metadata、文档和 run() 函数。

它不应该包含 routing、layout、animation、page state 或 prompt orchestration。

Agent 会拿到什么？

取决于 surface，Agent 或 host 会拿到结构化 schema、metadata 和 runtime result。Runtime invocation 会返回稳定 envelope，包含 ok、data 或 error、logs、artifacts 和 meta。

Auth 应该放在哪里？

放在你的应用里。Ageniti 提供 permissions、auth、user 和 permissionChecker hook，让你现有的授权模型可以一致地应用到多个 surface。

应该发布什么？

如果你在维护 Ageniti 本身，发布 SDK package。如果你在交付某个应用的 CLI/MCP/package 产物，发布 generated app bundle。

Guide 导出会调用 LLM 吗？

不会。GUIDE.md 是确定性的，它从你写下的 app 和 action metadata 生成。