用途:该技能封装 Granola 会议笔记的公开 API,用于读取工作区内可访问的会议笔记,适合在用户提到 Granola、会议笔记或 AI 笔记场景时调用。
主要能力:列出笔记(每页最多 30 条,默认 10 条);使用 cursor 分页遍历全部笔记;按 created_after、created_before、updated_after 过滤;获取单条笔记详情,包含摘要、参会人和日历事件;通过 include=transcript 获取完整会议转录。笔记 ID 格式为 not_ 加 14 位字母数字。
使用方式:API 基础地址为 https://public-api.granola.ai,请求需携带 Authorization: Bearer $GRANOLA_TOKEN。示例:curl -s -X GET "https://public-api.granola.ai/v1/notes?page_size=10" --header "Authorization: Bearer $GRANOLA_TOKEN" | jq .;获取单条笔记:curl -s -X GET "https://public-api.granola.ai/v1/notes/not_XXXXXXXXXXXXXX" --header "Authorization: Bearer $GRANOLA_TOKEN" | jq .;带转录:在 URL 后加 ?include=transcript。排障可运行 zero doctor check-connector --env-name GRANOLA_TOKEN 或 zero doctor check-connector --url https://public-api.granola.ai/v1/notes --method GET。
限制:API 密钥为只读权限,仅能访问工作区内公开笔记及工作区级文件夹共享的笔记;速率限制为每 5 秒 25 次突发、每秒 5 次持续(每分钟 300 次),需处理 HTTP 429 并退避;转录默认不返回;该 API 仅在企业版 Granola 计划中提供。