SuperAPI AI 工具集

grok

通用与其它

查看项目

更新于 10-15 22:17

技能介绍

用途:grok worker 把 xAI Grok CLI 封装为 iii 函数。一次 grok::run 调用执行一个无头 Grok 回合(grok --single <prompt> --output-format streaming-json),在指定目录中运行,使用与终端相同的 XAI_API_KEY、文件系统和工作目录,并返回最终结果。

主要能力:每个 Grok 事件原样镜像到 grok::events 流;翻译后的 AgentEvent 视图进入 agent::events,供 iii 控制台渲染。可一次委派完整编码任务,而非自行编排 coder::* / shell::* 调用;通过复用同一 session_id 跨调用续接会话并保留完整上下文;用 grok::start 立即返回 {session_id, started},再跟进事件流,适合长任务,可用 grok::stop 中断。回合默认携带 iii 运行时上下文(附加到会话首个提示),使智能体可通过 iii CLI 发现并调用已注册函数,可用 iii_context: false 关闭。

函数:grok::run 运行一个回合并等待,接受 prompt(或 messages 数组,最后一条用户消息作为提示)、model、cwd、always_approve、iii_context,返回 {session_id, grok_thread_id, result, stop_reason, num_turns};grok::start 同样载荷但立即返回;grok::stop 中断会话的实时运行;grok::status 返回 live 标志、状态与回合数;grok::sessions::list 列出该 worker 运行过的所有会话。

限制:每回合在宿主机上启动 grok CLI,需已安装并认证(XAI_API_KEY),裸容器中不可用。工具与命令执行由 Grok CLI 自身负责;无头回合默认自动批准(always_approve: true),设为 false 则由 CLI 审批策略把关。同一会话一次只能有一个回合,发送前应检查 grok::status(live: true),并行运行会因会话恢复而竞争。agent::events 只含整消息帧,逐项进度细节仅在 grok::events。需要 Grok 之外的能力时,应向总线添加其他 iii worker。