Document workspace ownership, resource semantics and agent lifecycle

This commit is contained in:
2026-10-09 18:06:25 +08:00
parent f7526ab2a0
commit 52f497671e
31 changed files with 748 additions and 232 deletions
+6 -5
View File
@@ -7,24 +7,25 @@
| UI | 函数返回的可渲染值、组件及展示效果 | [资源访问与呈现](../guide/11-resource-access-and-presentation.md)、[UI 组件](../guide/12-ui-components.md) |
| 业务逻辑 | 函数、结果、调用组合及业务效果 | [函数与调用](../guide/09-functions-and-calls.md) |
| 数据结构与访问 | class、共享类型、读取与字段使用 | [类型与类](../guide/07-types-and-classes.md)、[数据读取](../guide/10-data-access.md) |
| Agent | 后续的能力、上下文、任务及行为模型 | [规范状态](specification-status.md#agent) |
| 媒体与空间内容 | 图片、视频、音频和 GIS 资源,统一导入表示与导出编码 | [资源、类型与类](../guide/07-types-and-classes.md) |
| Agent | agent 声明、工具实现、记忆、状态及运行控制 | [Agent](../guide/13-agents.md) |
## 跨领域调用
普通调用是共有语义。UI、业务逻辑或后续 Agent 代码可以在允许访问的前提下使用相应逻辑,而不为跨领域调用建立独立的 RPC 协议声明。
普通调用是共有语义。UI、业务逻辑或 agent 代码可以在允许访问的前提下使用相应逻辑,而不为跨领域调用建立独立的 RPC 协议声明。
类似 RPC 的体验指“调用逻辑并取得结果”。输入、输出、依赖和失败需要在语言中明确,传输客户端、连接方式和缓存由系统承担。
## 领域与 namespace
`alice:shop.ui`、`alice:shop.pricing`、`alice:shop.data` 和 `alice:shop.agents` 是组织示例,不是强制目录或具有特殊行为的保留路径。
`atelier:shop.ui`、`atelier:shop.pricing`、`atelier:shop.data` 和 `atelier:shop.agents` 是 workspace 内的组织示例,不是强制目录或具有特殊行为的保留路径。
namespace 的名称不自动决定逻辑在何处执行。一个 namespace 也不必只包含一种声明类别。
## Agent 范围
Agent 尚无具体源码语法。需要独立定义的内容包括能力、工具、上下文、任务、生命周期、权限,以及确定性代码和模型驱动行为的边界。
agent 是语言资源声明,可以在内部实现函数,也可以引用外部函数;其成员共用 Endorphin 的变量、类型和调用模型,并具有 agent 内部作用域及运行关联。
本书不为尚未定义的领域提供虚构关键字或 API;其扩展仍应共用语言已有的组织与调用模型。
工具、记忆、状态、路由、人工中断和上下文管理的职责见[Agent](../guide/13-agents.md)。声明骨架为提案,具体成员关联、任务入口、模型配置和权限语法仍按[规范状态](specification-status.md#agent)记录。
[目录](../README.md)