JamJet
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/cloud
import { init } from '@jamjet/cloud'

init({
  apiKey: process.env.JAMJET_API_KEY!,
  project: 'my-app',
})
pip install jamjet
import 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 在重试后会被丢弃。

下一步

On this page