用途:该技能提供对 protocols.io API v3 的完整集成,用于以编程方式访问和管理科学实验方案、工作区、讨论、文件与协作功能。适用于方案检索、创建与发布、团队协作、实验记录等场景。
主要能力:
- 身份验证与访问:支持客户端访问令牌与 OAuth 流程,包括生成授权链接、用授权码换取访问令牌、刷新过期令牌、管理速率限制与权限。
- 方案操作:按关键词、过滤器或 DOI 搜索方案;获取含步骤的完整方案详情;创建、更新方案元数据与标签;管理步骤(增删改、排序);处理材料与试剂;发布并分配 DOI;收藏方案;生成方案 PDF。
- 讨论与协作:查看方案级与步骤级评论,创建评论与嵌套回复,编辑或删除自己的评论,分析讨论反馈。
- 工作区管理:列出与访问用户工作区,获取工作区详情与成员列表,请求加入,列出并创建团队方案,管理权限。
- 文件操作:搜索工作区文件与文件夹,上传带元数据与标签的文件,下载与校验,组织文件夹层级,更新元数据,删除与恢复文件。
- 附加功能:管理个人资料与设置,查询近期发布方案,创建与跟踪实验记录,处理通知,导出组织数据用于归档。
必要用法:所有请求的基础地址为 https://protocols.io/api/v3,请求头需包含 Authorization: Bearer YOUR_ACCESS_TOKEN。多数接口使用 JSON 格式,并可通过 content_format 参数控制返回格式(json、html、markdown)。使用前需获取访问令牌并安全存储,再按任务读取对应参考文件(authentication.md、protocols_api.md、discussions.md、workspaces.md、file_manager.md、additional_features.md)以获取端点、参数与工作流示例。
速率限制:标准接口每分钟每用户 100 次请求;PDF 接口每分钟 5 次(已登录)或 3 次(未登录)。遇到 HTTP 429 应实现指数退避重试。
适用场景:方案发现与引文,创建并发布带 DOI 的协议,实验室协作工作区管理,文件上传与归档,实验执行记录与复现性分析,数据导出备份。
限制:功能依赖有效的 protocols.io API 访问令牌与相应权限;部分操作需工作区成员身份;文件上传受工作区大小与类型限制;本技能不提供独立界面,需通过 API 调用使用。具体收费、价格与官方支持渠道暂未提供。