# OptMetron Coze 插件

## 安装到 Coze

### 方式 1: 通过 OpenAPI URL
1. Coze 控制台 → 插件 → 创建插件
2. 选择 "导入 OpenAPI"
3. 填入 URL: `https://optmetron.com/api/openapi.json`
4. 配置认证: Bearer Token（生产环境）
5. 发布插件

### 方式 2: 手动导入
1. 下载 `plugin_manifest.yaml`
2. Coze 控制台 → 插件 → 创建插件
3. 上传清单文件
4. 配置认证

### 方式 3: 本地开发
```bash
pip install optmetron-core[api]
optmetron serve --port 8400
```
然后在 Coze 中使用 `http://localhost:8400` 作为 API 地址。

## 在 Bot 中使用

在 Coze Bot 编排中调用 OptMetron 工具：

```
用户提问 → Bot 回复 → 调用 meterCall 记录 Token 消耗
用户问"我花了多少钱" → 调用 getLedger 查询
多 Bot 协作 → 调用 settleAgents 分账
```

## 典型 Workflow

```
Workflow: 智能客服 + 成本追踪

1. 用户输入
2. Bot 调用 LLM (deepseek-v4)
3. 【OptMetron 工具】 meterCall(token_count=2500, agent_id="客服Bot")
4. Bot 输出回复 + 本次成本提示
```

## 认证

生产环境需要 API Key 认证。在 Coze 插件设置中配置：
- 认证方式: Bearer Token
- Token: `<your-optmetron-api-key>`