Connect Agent

给 Agent 一层可审计的本地声音接口

Codex、OpenClaw、Hermes Agent、Cursor、Claude Code 和脚本可以通过本地 manifest 发现能力、提交任务、追踪 artifact；用户仍能在桌面端看到模型、声音、历史和审计。

/agent/manifest /v1/audio/speech /v1/jobs/*

$ curl 127.0.0.1:19280/agent/manifest?view=slim
{
  "ready": true,
  "speech": ["qwen3-tts", "kokoro"],
  "transcribe": ["qwen3-asr", "whisper"],
  "artifacts": "local"
}

Discover读取 manifest只暴露当前 ready 能力。

Submit提交 job长任务不阻塞上下文。

Trace追踪 artifact结果可复用、可审计。

Review回到桌面用户能看到调用边界。

本地能力层

不绕过 GUI，不另起一套临时 API

Agent 调用与桌面 GUI 共用模型、声音、job、artifact、history 和 audit。一次外部调用可以被用户审查、恢复、导出和追踪。

curl http://127.0.0.1:19280/agent/manifest?view=slim

POST /v1/audio/speech
POST /v1/audio/transcriptions
POST /v1/jobs/audio/voice-conversion

可见性

Agent 提交的长任务，用户也能在桌面端看见

Agent 接入最怕变成后台黑箱。Sonano 把外部调用放进同一套 job、artifact、history 和 audit 体系，用户可以看到进度、定位失败，也能回到历史里复用结果。

Jobs

长任务进度可追踪

下载、生成、转写和转换进入统一任务列表，适合 Agent 的异步调用方式。

Audit

外部调用有边界记录

caller、endpoint、request id 和结果状态都留在本机，方便用户审查自动化行为。

Manifest discovery

Agent 先读 `/agent/manifest` 获取当前 ready 能力、推荐默认值、端点和错误边界。

OpenAI-compatible

兼容 `/v1/audio/speech` 与 `/v1/audio/transcriptions`，方便已有脚本迁移。

Async jobs

长任务使用 job 提交、轮询、取消和 artifact 查询，不阻塞 Agent 工作流。

Agent Skill

官方 skill 可安装到 Shared `.agents`、OpenClaw、Hermes、Cursor、Codex 等环境。

Audit

有意义的外部调用会进入本地审计，用户能看到谁调用了什么能力。

Loopback by default

默认服务地址是 `127.0.0.1:19280`，优先面向本机自动化。

Agent 工作流

一次 Agent 调用会留下可审查的本地痕迹

读取 manifest

Agent 获取当前 ready 模型、推荐默认值、端点、语言和能力边界。

提交能力调用

语音生成、转写、声音转换可使用同步或异步 job 方式执行。

追踪 job

长任务进入任务与进度，用户和 Agent 都能查看状态、进度和失败信息。

引用 artifact

结果不是临时文件，而是可播放、可导出、可由后续任务继续引用的 artifact。

进入 history

有价值的生成和处理结果可回到桌面工作区复用、审计和导出。

写入 audit

请求审计展示 caller、endpoint、request id、结果状态和错误边界。