SuperAPI AI 工具集

huly-api

编程与开发

查看项目

更新于 10-16 04:34

技能介绍

用途:让 swarm 智能体在 Huly 中进行持久化沟通与协作,覆盖三类界面:tracker 任务看板(issues)、chunter 频道(聊天消息)、document teamspace(任务文档)。每个自治任务应在三处同步更新。默认目标为 Tracker 的 DefaultProject、Docs 的 PROOMPTENG 团队空间,以及从运行上下文动态解析的频道。

主要能力:通过 scripts/huly-api.py 提供多操作,包括读取频道历史(list-channel-messages)、发频道消息(post-channel-message)、创建问题(create-issue)、创建文档(create-document)、账户信息(account-info)、聊天访问校验(verify-chat-access)、任务级同步(upsert-mission)、修复项目问题(repair-project-issues)、去重任务问题(dedupe-project-mission-issues)、修复团队空间文档(repair-teamspace-documents)以及原始 HTTP 调试(http)。upsert-mission 会同时创建或更新一个任务板问题、一份任务文档和一条频道消息。

使用方式:凭据从 huly-api 的 Kubernetes secret 经 AgentRun spec.secrets 加载,需要 HULY_API_BASE_URL(指向 transactor)、HULY_API_TOKEN(bearer token),以及可选的 HULY_BASE_URL、HULY_WORKSPACE、HULY_WORKSPACE_ID、HULY_PROJECT、HULY_TEAMSPACE、HULY_CHANNEL 等。支持每智能体 token(HULY_API_TOKEN_<身份>)。脚本路径在 bundled 镜像中为 /root/.codex/skills/huly-api/scripts/huly-api.py,Jangar runner 镜像也复制到 /app/skills/huly-api/scripts/huly-api.py,可用 HULY_API_SCRIPT_PATH 覆盖。频道交互循环为:先读取最近频道历史,再以 --reply-to-message-id 在主题内回复相关队友消息,最后发布本阶段更新。使用 --require-worker-token 强制专用账户校验,可配合 --require-expected-actor-id 与 HULY_EXPECTED_ACTOR_ID_<身份> 做严格身份映射。

限制:仅依据资料,未提供收费、价格、平台支持范围或效果数据。需要正确的凭据与环境变量;鉴权失败时应停止并返回明确的解除阻塞请求,不应静默继续。频道消息默认保持人类可读,避免附加元数据块,除非使用 --append-channel-metadata。问题描述与文档内容需为长篇知识库质量,通过 collaborator refs 存储而非内联 markdown。