跳到主要内容
知识地图外部 API 接进 AFS 后,什么没有改变?ArcBlock 体系

你在这里。看看这个问题与其他知识怎样相连。

选择节点前往页面 · 展开后可留在地图中阅读

知识地图沿着连接,读懂一个问题
← AFS

一个问题

外部 API 接进 AFS 后,什么没有改变?

服务的权限、延迟和副作用仍然存在,需要通过接口表达。

同一种入口,真实的远端约束

HTTP、MCP 或消息服务 provider 可以把外部资源和动作组织进 AFS。它们提供的是适配:将路径、参数和返回结果连接到真实服务。

例如“读取消息”与“发送消息”不能因为都叫工具调用就混为一谈。前者可能分页或限流;后者可能向别人发送内容。超时也不一定意味着操作没有发生,重试发送前要理解服务的幂等或去重能力。

一个 provider 应该解释什么

  • 如何定位资源,以及分页后是否仍能稳定引用。
  • 操作参数、结果与可能的外部效果。
  • 认证失败、无权限、资源不存在、限流与临时故障的区别。
  • 哪些状态会缓存,怎样获得更新信息。

把错误统一变成空列表,会让“没有内容”和“无法读取”无法区分。共同接口的价值,是让这些差异被一致发现,而不是把它们藏起来。

检查一下理解

外部 API 接进 AFS 后,什么没有改变?

服务的权限、延迟和副作用仍然存在,需要通过接口表达。

沿着学习路径继续