Workbench 开发者文档English

实用示例

用 wb 一步步完成三项日常任务。Workbench 每次变更时,都会以一家测试公司的公司管理员身份,原样运行本页的每一条命令,所以本页始终与服务器的实际行为一致。

开始之前,先运行一次 wb login 登录(见快速入门)。每个示例都需要对应连接的公司密钥:wb connections 会列出贵公司已有的连接。

在 DigiKey 上查找器件

先按关键词搜索 DigiKey,再读取所需器件的详细信息。首先搜索,正文就是 DigiKey 自己的关键词搜索请求:

wb call digikey products/v4/search/keyword --data '{"Keywords": "MMBT3904", "Limit": 5, "Offset": 0}'

响应中的 Products 列出匹配的器件。每一项都有 ManufacturerProductNumber、QuantityAvailable 和 UnitPrice,以及 ProductVariations(卷带、剪切带等包装),每种包装都有自己的 DigiKeyProductNumber。然后按 DigiKey 料号读取一个器件的详细信息:

wb call digikey products/v4/search/MMBT3904LT1GOSCT-ND/productdetails

响应中的 Product 是完整记录:阶梯价格、库存、数据手册链接和参数。

如果要在脚本中使用响应,在命令后加上 > part.json,再用 jq 或您自己的代码读取该文件。

从 MRPeasy 读取采购订单

直接从 MRPeasy 读取贵公司的采购订单和供应商。首先是采购订单:

wb call mrpeasy rest/v1/purchase-orders

每张采购订单都有 code、vendor_title、status、currency 和 products:每个订单行一项,含 item_code 和 quantity。然后读取供应商,用 vendor_title 对应到供应商记录:

wb call mrpeasy rest/v1/vendors

MRPeasy 的长列表分页返回;这两条命令读取的是第一页。

通过 AI 中继调用模型

向 Anthropic 的 Messages API 发送提示。调用经过 Workbench 的 AI 中继:使用贵公司的密钥和贵公司允许的模型,并计入贵公司和您本人的每月 AI 预算。

wb call anthropic v1/messages --data '{"model": "claude-sonnet-5-5", "max_tokens": 512, "messages": [{"role": "user", "content": "In one sentence, what is an MMBT3904?"}]}'

响应就是 Anthropic 的消息:回复在 content 中,usage 是计入预算的 token 数。请只请求完整响应:试用期间带 "stream": true 的请求会被拒绝。如果想询问在 DigiKey 上找到的器件,把它的详细信息放进消息的 content 即可。

某一步失败时

wb 以非零状态退出,并打印 Workbench 给出的原因。限制与错误列出了所有原因,例如缺少公司密钥或预算已用完。