白标端点是经销商添加到其以自己名义销售的 API 上的端点。它不是新能力 — 而是该 API 已有的几个操作,按顺序排列,放在经销商选定的一个地址和一个名称之后。它的客户调用它的方式和调用其他任何东西一样,客户的助手则在工具列表里看到它,与构成它的那些操作并排。
经销商为什么想要它
因为它卖的产品通常不是某一个操作。“我们替你把名单预热一遍”,是一次搜索,然后对每个结果做一次反应,再向写下这些内容的人发出邀请 — 四次调用,它的客户的助手每一次都得做对,而且顺序不能乱。一个端点则是同样的工作,只命名一次,用经销商自己的话来描述。
它能用什么搭建,不能用什么搭建
只能用经销商自己方案所包含的操作。自有端点是穿过它所购买的 API 的捷径,绝不是绕开这个 API 的办法:某个步骤如果点名了方案之外的东西,会在编写端点时被拒绝,而不是在运行时。
条件和循环是允许的,表达式语言则不允许。值是普通的 JSON,或者从迄今为止的运行中读出的路径,条件则是一次比较。不会对任何内容求值,因为端点由客户编写、保存,然后在提供方的服务器上针对真实账号运行。
一次调用最多能花多少
循环意味着端点可能请求比任何人原本打算的更多的工作,所以一次运行设有上限:操作的数量、迭代的次数和运行时长。触及上限是一个答复,而不是一个错误 — 它会说明已经做完了什么,因为已发出的消息无法收回。
每个步骤都作为一个全新的请求单独授权,所以第一步产生的 id 会再次自证身份,第二步才可以使用它。组合出来的端点不是跳过内部各操作自带检查的办法,它消耗的节奏预算也和那些操作一样。
另一半:把我们的拿掉
经销商也可以隐藏不想提供的操作。隐藏会把一个操作从工具列表、清单文件和参考文档里拿掉;路由仍然会应答,所以已经在调用它的客户不会因为一句话做出的改动而出问题。想把整个领域都去掉的经销商,则是改为不再提供那个领域。
常见问题
AI 智能体能替我写一个这样的端点吗?
这通常就是做法。描述端点应该做什么、该用你的哪些操作,助手就会写出步骤并保存。如果它伸手去拿你的方案里没有的操作,会按名称被拒绝,所以猜错的内容会被纠正,而不是被存下来。
自有端点运行起来更贵吗?
它的费用就是里面各个操作的费用。一次执行四个动作的调用,消耗的节奏预算和分别执行这四个动作的四次调用一样,因为每个步骤都作为独立的请求单独授权、单独控制节奏。