你在这里。看看这个问题与其他知识怎样相连。
选择节点前往页面 · 展开后可留在地图中阅读
一个问题
外部 API 接进 AFS 后,什么没有改变?
服务的权限、延迟和副作用仍然存在,需要通过接口表达。
同一种入口,真实的远端约束
HTTP、MCP 或消息服务 provider 可以把外部资源和动作组织进 AFS。它们提供的是适配:将路径、参数和返回结果连接到真实服务。
例如“读取消息”与“发送消息”不能因为都叫工具调用就混为一谈。前者可能分页或限流;后者可能向别人发送内容。超时也不一定意味着操作没有发生,重试发送前要理解服务的幂等或去重能力。
一个 provider 应该解释什么
- 如何定位资源,以及分页后是否仍能稳定引用。
- 操作参数、结果与可能的外部效果。
- 认证失败、无权限、资源不存在、限流与临时故障的区别。
- 哪些状态会缓存,怎样获得更新信息。
把错误统一变成空列表,会让“没有内容”和“无法读取”无法区分。共同接口的价值,是让这些差异被一致发现,而不是把它们藏起来。