JamJet CloudGet started
快速开始
在 5 分钟内为任何 AI 应用添加 JamJet Cloud 治理。支持 TypeScript 或 Python。
云端快速入门
本指南为现有 AI 应用添加 JamJet Cloud 治理功能——策略、预算、审批、审计日志。约 5 分钟完成,无需重构代码。
1. 注册账号
在 app.jamjet.dev 创建免费账号。免费套餐足够完成本快速入门和日常开发使用。
注册后,创建一个项目并从 设置 → API 密钥 复制你的 API 密钥。格式类似 jj_xxxxxxxxxxxx。
密钥创建后无法再次获取。如果丢失,请在项目设置中创建新密钥。
2. 安装并初始化
pnpm add @jamjet/cloudimport { init } from '@jamjet/cloud'
init({
apiKey: process.env.JAMJET_API_KEY!,
project: 'my-app',
})pip install jamjetimport jamjet.cloud as jamjet
import os
jamjet.configure(
api_key=os.environ['JAMJET_API_KEY'],
project='my-app',
)3. 添加治理功能
包装你现有的 OpenAI / Anthropic 客户端,并添加策略和预算:
import OpenAI from 'openai'
import { wrap, policy, budget } from '@jamjet/cloud'
policy('block', 'wire_*') // 阻止匹配 wire_* 的工具
budget(50) // 项目预算上限 $50
const openai = wrap(new OpenAI())
// 正常使用——每次调用都会被治理和监控
await openai.chat.completions.create({
model: 'gpt-4o',
messages: [{ role: 'user', content: 'Hello!' }],
})from openai import OpenAI
jamjet.policy('block', 'wire_*') # 阻止匹配 wire_* 的工具
jamjet.budget(max_cost_usd=50) # 项目预算上限 $50
client = jamjet.wrap(OpenAI())
client.chat.completions.create(
model='gpt-4o',
messages=[{'role': 'user', 'content': 'Hello!'}],
)完成。现在包装后客户端的每次调用都会显示在 app.jamjet.dev 控制台中,包含完整的归因信息、成本和策略决策。
验证
打开控制面板。你应该能看到刚才调用的 span — 通常在 ~5 秒内出现。点击它可以查看请求负载、响应、成本以及 agent 归属(默认 agent:default)。
如果调用未显示:
- 检查 API 密钥是否与你的项目匹配(设置 → API 密钥 中的
jj_...)。 - 确认
init()/configure()在第一次 LLM 调用之前执行。 - SDK 采用故障开放设计:如果
api.jamjet.dev不可达,你的 agent 会继续运行,但 span 在重试后会被丢弃。