Docs/ AI 助手/ 入门指南

AI 入门指南

四步从零到一个了解您服务器内外的 AI 助手。

第 1 步:购买 AI 积分

导航至 sh0.dev/account/ai 并购买积分包。提供五种面额:

积分包大约对话数 (Sonnet)
$5~1,000
$10~2,000
$25~5,000
$50~10,000
$100~20,000

三个 Claude 模型(Haiku、Sonnet、Opus)在所有计划中均可用。积分永不过期——随时使用。

第 2 步:创建 AI API 密钥

在同一 账户页面,点击 Generate AI Key。您的密钥以 sh0_ai_ 开头,仅显示一次。

Warning
生成后立即复制您的 API 密钥。之后无法再次获取。如果丢失,请撤销并生成新的。

创建密钥时,选择作用域:

  • Read——只能查询数据(列出应用、查看日志、检查状态)。最安全的监控选项。
  • Standard——可读写(重启应用、部署、设置环境变量)。推荐日常使用。
  • Admin——完全访问权限,包括销毁操作(删除应用、删除数据库)。谨慎使用。

第 3 步:配置您的控制台

打开您的 sh0 控制台并导航至 Settings。在 AI 部分,粘贴您的 sh0_ai_ 密钥。

密钥存储在浏览器的 localStorage 中。它永远不会发送到 sh0 的服务器——仅用于直接与您的 sh0 实例的 AI 端点进行认证。

Note
您的对话存储在浏览器本地。sh0 永远不会存储或读取您的聊天历史。

第 4 步:开始聊天

在控制台中打开 /ai。AI 自动检测您的服务器上下文——运行中的应用、资源指标、sh0 版本和配置。无需手动设置。

用自然语言输入问题或命令。助手将确定要调用哪些工具,在您的服务器上执行它们,并返回结果和分析。

选择模型

从聊天界面的下拉菜单中选择模型。每个模型有不同的优势:

模型速度每次对话成本推荐用途
Haiku约 1-2 秒约 $0.002快速状态检查、列出应用、简单问题
Sonnet约 3-5 秒约 $0.005调试失败部署、多步操作、日常使用
Opus约 8-15 秒约 $0.009复杂根因分析、架构审查、沙箱代码分析
Tip
大多数任务使用 Sonnet。速度优先于深度的快速查询使用 Haiku,需要深入分析复杂问题时使用 Opus。

示例对话

以下是您可以问 AI 助手的一些问题:

  • "为什么我的上次部署失败了?"——AI 获取部署日志,识别错误,并建议修复方案。
  • "列出我所有的应用及其状态"——调用 list_apps 并展示汇总表。
  • "为我的 Node.js 项目生成 sh0.yaml"——基于最佳实践创建部署配置。
  • "检查我的数据库是否可以从 my-app 访问"——使用沙箱测试容器间的网络连通性。
  • "我的应用占用太多内存。帮我调试。"——检查指标,检查日志,可能在沙箱中分析代码。
  • "重启 my-api 并监控日志"——重启应用并流式传输启动日志以验证恢复正常。
  • "frontend 最后一次部署改了什么?"——查看部署历史和构建日志以汇总变更。

BYOK(自带密钥)

Business 计划用户可以通过提供自己的 LLM API 密钥完全绕过积分系统。这提供零加价定价——您直接按提供商的公开费率付费。

支持的密钥格式:

  • Anthropic——以 sk-ant- 开头的密钥。直接访问 Claude 模型。
  • OpenRouter——以 sk-or- 开头的密钥。通过 OpenRouter 的统一 API 访问 Claude 和其他模型。

要配置 BYOK,请在控制台的 Settings 中,在 AI 部分输入您的提供商密钥。密钥像 sh0 AI 密钥一样存储在浏览器本地。

Note
BYOK 密钥从您的浏览器直接发送到 AI 提供商。sh0 作为代理注入您的服务器上下文和工具定义,但永远不会存储或记录您的提供商密钥。