Sally Skills

Sally Skills

Sally 是专注于代谢健康的专业智能服务。Sally Skills 让开发者能够通过 Sally Console，使用 REST API 和 MCP 将 Sally 的专业能力集成到 AI Agent 中。

可用能力包括：

• 🩸 健康背景 — 理解 64+ 项生物标志物，包括血糖、HbA1c、睡眠、活动、生命体征和环境信号。
• 🧪 实验室分析 — 将实验室检查结果转化为具有临床意义的代谢健康洞见。
• 💊 补充剂组合评分 — 对补充剂组合的质量、有效性和代谢健康相关因素进行评分和评估。
• 🥗 营养分析 — 分析膳食和营养素，识别更健康的选择，并检测潜在的代谢陷阱。
• 📈 代谢概览 — 解读连续血糖监测仪（CGM）数据，揭示血糖模式和代谢健康趋势。
• 🌤️ 每日洞见 — 使用睡眠、生命体征、活动和环境数据总结每日健康状况，并提供个性化洞见。
• 🩻 胸部与骨折 X 光分析 — 分析胸部和肌肉骨骼 X 光片，协助识别具有临床意义的 发现。
• 📚 长寿知识 — 获取 Sally 精选的代谢健康与长寿知识，结合西医和 中医（TCM）的证据。

兼容 Claude Code、Claude Desktop、Cursor、OpenClaw、Hermes、Manus、Perplexity，以及任何支持 REST API 或 MCP 的 AI 框架。

生态系统

• Sally — 专注于代谢健康和长寿的 AI。
• A1C Insights — 消费者应用，用户可在其中连接健康数据，并通过 Ask Sally 与 Sally 对话。
• Sally Console — 开发者平台，用于通过 REST API 和 MCP 将 Sally 的能力集成到 AI Agent 中。

第 1 节：开始使用

在 Agent 能够调用任何 Sally 技能之前，你（人类）需要一个 API 密钥。有两种方式可以开始，你可以任选其一。

方式 A：从控制台开始（最快）

1. 访问 https://console.a1c.io，使用 Apple 或 Google 注册。无需安装应用，也无需排队等候。
2. 打开 API Keys，点击 Create new key，为密钥命名（例如“我笔记本上的 Claude Code”），然后点击 Generate。
3. 立即复制密钥。 密钥以 sk-sally-… 开头，且只会显示一次。如果丢失，请撤销并重新生成。

这样你就能立即获得一个可用密钥，并访问 Sally 的专业推理能力以及精选的代谢与长寿知识库。

仅使用控制台密钥时，目前可调用的技能：

技能	无生物标志物时可用
chat_with_sally	是
analyze_lab_result	是
food_journal	是
supplement_grading	是
search_health_knowledge	是，免费
lookup_supplement_grade	是，免费
lookup_food	是，免费
health_sync	需要生物标志物
health_insights	需要生物标志物
metabolic_overview	需要生物标志物

最后三项会读取你自己的 CGM 和可穿戴设备数据，因此没有这些数据时，它们会立即返回类型化的 no_health_data 错误，且不收取任何费用。在方式 B 中连接你的生物标志物后，这些技能就会开始提供解答。

路径 B. 使用 A1C Insights 添加你自己的生物标志物

如果你想了解自己的血糖、睡眠和化验结果，而不是一般领域知识，请按此操作。

1. 在 iPhone 上打开 App Store。
2. 搜索 A1C Insights 并安装，或者在手机上打开 https://apps.apple.com/id/app/a1c-insights/id6748399956。
3. 使用你在控制台上使用的同一账号登录；如果是从这里开始使用，请轻点 Sign Up。
4. 按照引导流程操作（填写基本信息、目标，可选连接可穿戴设备），并连接 CGM 或可穿戴设备。

 

带注释截图的可视化操作指南： https://console.a1c.io/docs.html#quickstart。

Sally Console 和 A1C Insights 使用同一个后端，因此两者的账号和密钥相同。 已经在使用 A1C Insights？直接登录控制台即可，你的密钥可用于访问已同步的数据。

为什么生物标志物功能需要 iOS？metabolic_overview、health_insights 和 health_sync 等技能会读取 iPhone 应用通过 HealthKit 收集的 CGM 和可穿戴设备数据。其他功能仅需控制台账号即可使用。

密钥和账单

每个账号可以创建多个密钥，每个 Agent 或设备使用一个，所有密钥共用同一钱包余额。每个密钥的用量都可审计。你可以使用银行卡充值、通过 Base 上的 USDC 充值，或选择不限量月度套餐。

第 1 部分到此完成。现在你拥有：

• 一个账号，可在适合你的地方创建。
• 一个已充值的钱包。
• 一个已复制到剪贴板的 sk-sally-… API 密钥。

第 2 部分：从任意 Agent 使用你的密钥

你有一个密钥。以下是使用它调用 Sally 的三种方式。大多数 Agent 只需要使用 MCP 路径。除非你要从命令行编写脚本，否则请选择此方式。

2a. 技能目录

密钥生效后，以下七项技能即可使用（实时列表见 console.a1c.io）：

技能	每次调用费用	功能说明	详情
supplement_grading 🆕	$0.008	评估补充剂组合的相互作用、证据质量和不足之处。	—
health_sync	每月免费 10 次，之后 $0.001	将可穿戴设备和 CGM 的 64+ 项实时生物标志物数据导入 Agent 的上下文。	64 项字段
chat_with_sally	$0.003	就预防性健康和中医领域的任何问题向 Sally 提问，并获取经过证据分级的回答。	用法
analyze_lab_result	$0.008	解析并解读化验项目，提供风险标记和参考范围。	用法
health_insights	$0.003	根据睡眠、生命体征和活动数据，提供早间、午后和晚间分析。	用法
food_journal	$0.004	根据宏量营养素和血糖升高预测评估餐食，并揭示规律。	用法
metabolic_overview	$0.005	完整的 CGM 快照：目标范围内时间、变异性和餐后曲线。	用法

路线图上即将推出：health_report、metabolic_risk_score、 xray_skills 和 preventive_protocol。

请参阅 catalog/ 了解各项技能的完整数据说明。

2b. 三种调用方式

路径	最适合用于	设置
MCP	任何现代 AI Agent（Claude、Cursor、OpenClaw、Hermes、Manus、Perplexity 等）。	一个 JSON 配置块，重启 Agent，工具便会自动显示。
REST API	Bash 脚本、自有应用，以及任何可使用 curl 的场景。	每次调用发送一个 HTTP POST。
Per-skill REST	与 REST 相同，但每个技能的 URL 稍简洁。	/v1/skills/<name>

查看 protocols/mcp.md，了解通用 MCP 设置； 查看 protocols/api.md，了解原始 REST 调用；以及 查看 agents/，获取各 Agent 的快速入门指南。

2c. 为 Agent 和 CLI 自动路由

希望 Agent 能针对任意请求自动选择合适的 Sally 技能，无需你费心？将 SKILL.md 放入 Agent 的系统提示词或指令字段中。该文件包含确定性路由规则、决策表、链式调用模式和反模式。适用于任何基于大模型的 Agent 或基于规则的 CLI。

查看 SKILL.md，了解完整的 Agent 决策层。

2d. 30 秒冒烟测试

在配置任何 Agent 之前，确认你的密钥可用：

curl -sS https://sally.a1c.io/v1/call \
  -H "Authorization: Bearer sk-sally-…" \
  -H "Content-Type: application/json" \
  -d '{"skill":"health_sync","input":{}}' | jq .ok
# → true

true 表示你的密钥已启用，可以调用 health_sync（每月前 10 次调用免费）。现在可以开始了。

各 Agent 指南

选择你实际使用的 Agent：

• Claude Code。终端编码助手。
• Claude Desktop。macOS / Windows 应用。
• OpenClaw。开源 Agent CLI。
• Hermes。Agent 运行时。
• Manus。中文 Agent 平台。
• Perplexity。以搜索为先的 AI。

没看到你的 Agent？大多数现代 Agent 都支持 MCP。查看 protocols/mcp.md，并使用通用配置。

定价和钱包

• 按次计费，无需订阅。请参阅上表。health_sync 每月包含 10 次免费调用，之后每次调用收费 $0.001。
• 每次调用前都会检查钱包余额。如果余额低于价格，付费技能会返回 402 payment_required，因此不会产生意外费用。
• 通过 Stripe 在 https://console.a1c.io/billing 充值。支持以 USD 刷卡付款。
• 每次调用都会在使用记录中写入一条不可更改的记录。可在 console.a1c.io 的 Usage 下查看。

隐私与安全

• 密钥就是你的身份。Sally 绝不接受 Agent 请求正文中的 user_uuid、email 或任何其他标识符，只接受 Authorization: Bearer sk-sally-… 标头。任何 Agent 都无法冒充其他用户。
• Sally 不会保存实验室 PDF 或餐食照片。它们会经由 Agent → 网关 → AI 服务 → 响应传递，不会上传到 S3 或 GCS。
• 输出架构采用允许列表。Sally 的响应只会包含各技能文档中明确列出的字段。内部数据库中的列不会意外泄露。
• 可在 console.a1c.io 的 API Keys → Revoke 下立即撤销。旧密钥会从下一次请求起失效。

帮助

• 技能目录及字段级文档：catalog/
• 自动路由层：SKILL.md
• 电子邮箱：[email protected]