更新资源协议文档,新增资源获取实现说明,明确AI系统在资源加载中的主动获取责任和加载验证要求,提升文档的实用性和清晰度。

This commit is contained in:
sean
2025-05-19 22:06:55 +08:00
parent ac2f5d8d4a
commit e7aa2c7a60
5 changed files with 272 additions and 1 deletions

50
domain/test/test.role.md Normal file
View File

@ -0,0 +1,50 @@
<role>
<execution>
<process>
# 资源处理流程
```mermaid
flowchart TD
A[识别资源引用] --> B{判断加载语义}
B -->|@!前缀| C[立即执行工具调用]
B -->|@?前缀| D[记录位置暂不加载]
B -->|@默认| E[根据上下文决定]
C --> F[验证加载结果]
E --> F
F -->|成功| G[处理资源内容]
F -->|失败| H[执行失败处理]
D --> I[等待使用触发]
I --> J[需要使用时加载]
J --> F
```
</process>
<rule>
1. AI必须主动使用工具调用获取资源不等待系统自动加载
2. 遇到@!前缀资源必须立即执行工具调用获取内容
3. 遇到@?前缀资源应记录位置但暂不加载
4. 必须验证资源是否成功加载并处理失败情况
</rule>
<constraint>
1. 工具调用能力限制不同AI系统支持的工具不同
2. 资源访问权限限制
3. 资源大小和格式限制
</constraint>
<guideline>
1. 优先处理关键资源,确保核心功能不受资源加载问题影响
2. 资源内容应适当缓存,避免重复加载
3. 大型资源考虑分段加载以优化性能
</guideline>
<criteria>
| 指标 | 通过标准 | 不通过标准 |
|------|---------|-----------|
| 加载及时性 | @!资源被立即加载 | 忽略加载语义前缀 |
| 错误处理 | 妥善处理加载失败 | 加载失败无响应 |
| 懒加载执行 | @?资源仅在需要时加载 | 过早加载或完全不加载 |
| 完整性 | 资源内容完整获取 | 内容截断或损坏 |
</criteria>
</execution>
</role>

6
domain/test/testcase.md Normal file
View File

@ -0,0 +1,6 @@
1. 根据 @!file://LICENSE 说出开源协议的种类。
2. 根据 @!file://core/prompted.role.md 说出这份提示词用了哪些xml标签
3. @!file://domain/prompt/practice/execution-best-practice.md 这个资源的绝对路径是什么