用途
Monologue Notes 用于让智能体以只读方式访问 Monologue Notes 中的用户笔记。适用于需要读取、检索、罗列和分页获取笔记的场景，例如查找某次客户访谈记录、按主题或人物搜索笔记、获取单条笔记的转录内容或原始录音链接。
主要能力
当前公开接口包括：
GET /v1/public-api/notesGET /v1/public-api/notes/{note_id}GET /v1/public-api/notes/{note_id}/audio-url
通过 monologue CLI 可执行：
monologue notes list --limit 10：列出笔记monologue notes list --q "customer interview"：按关键词搜索monologue notes list --tag-id TAG_UUID：按标签筛选monologue notes all --updated-after 2026-01-01T00:00:00Z：分页获取更新后的全部笔记monologue notes get note_123：获取单条笔记monologue notes get note_123 --field transcript：仅取转录文本monologue notes get --field summary note_123：仅取摘要monologue notes get note_123 --field recording_url：获取原始录音链接monologue notes audio-url note_123 --field audio_url：获取带有效期的临时录音链接
录音访问需要 CLI v0.3.0 或更高版本。notes get 会返回原始录音链接、UTC 过期时间、内容类型和字节数；notes audio-url 返回新的链接及其有效秒数。
使用方式
如缺少 monologue CLI，安装命令为：
curl -fsSL https://raw.githubusercontent.com/EveryInc/monologue-toolkit/main/install.sh | sh
如尚未配置凭据，需由用户在自己的交互式终端中运行 monologue onboarding，并在 Monologue 应用中创建 API token。该步骤只能由用户本人完成，不应要求用户在聊天中粘贴 token，也不得将 token 放入工具调用、命令参数、日志或回复中。
检索前应先确定范围：主题、相关人员、项目、日期范围和用户时区；将相对日期按用户时区解析为 ISO 8601 边界。匹配录音时间范围应使用 recorded_at 而非 created_at，因为创建时间过滤可能遗漏延迟上传的笔记。搜索时应使用多个针对性查询（主题、人物、项目、独特短语），并将列表或搜索命中的结果仅视为候选，再逐条用 get NOTE_ID 核验日期、参与者和主题是否真正匹配。若首次搜索无结果，可逐步放宽一个维度再试，并报告检查过的范围和查询，不能据此断言不存在相关笔记。
回答方面，用户索取近期笔记或摘要时，宜提供简短摘要而非原始 JSON；除非用户明确要求或后续操作需要，否则不暴露 note_id；每个来源应给出人类可读的出处标注，如笔记标题和用户时区下的日期；直接转录证据与推断需明确区分，引号只用于转录中实际出现的词句。多笔记回答应末尾列出实际使用的来源。
适用场景
- 查找和总结近期会议或访谈笔记
- 按人物、项目、标签或时间范围检索笔记
- 获取单条笔记的摘要、转录或录音链接
- 为智能体提供基于已核验笔记的摘要与溯源
限制与约束
该技能是只读的，不提供创建、更新或删除端点。时间过滤参数需使用 ISO 8601 格式。应优先使用 CLI 而非临时 curl，以保持认证、错误处理和分页一致。不得静默将个人笔记混入工作摘要；如分类存疑且会影响答案，应先询问用户。只有在转录同时支持说话人身份和承诺内容时，才能将决定、承诺或待办归因于特定说话人；说话人标签未经核实时应表述为“一位未识别说话人”。签名链接在过期前无需 API token 即可访问，应避免出现在共享回复和日志中。