Cloudflare AI代理与OpenTetry
一个自给自足的 Cloudflare Workers 模板特征:
- AI代理框架: Cloudflare代理 与当地 主控程序-样式工具(无需外部服务)
- Web框架: 荣誉 关于Cloudflare Workers的API
- 可观测性:已满 开放遥测 跟踪包括请求、LLM调用和工具使用
- 地方发展:OTel跟踪导出到
localhost:4318/v1/traces随着 杜伊酒店 可视化
先决条件
- Cloudflare帐户: 每月5美元的带薪工人计划 (包括AI推理访问)
- 本地设置:```bash
npm install -g wrangler
wrangler login
> 有关Cloudflare Workers的完整设置,请参阅: 入门指南
## 快速开始```bash
npm install
npm run dev # Start local dev server with hot reload
部署到Cloudflare:```bash
npm run deploy
从Cloudflare配置同步类型:```bash
npm run cf-typegen
> 看 wrangler命令参考 了解更多
项目结构
src/index.ts:Hono应用程序入口点CloudflareBindingssrc/sandbox-agent/:Cloudflare代理实施src/tools/:MCP风格的工具定义(本地,无外部服务)src/tests/:测试套件wrangler.jsonc:Worker配置和绑定
关键技术
Hono框架
> 一个适用于任何JavaScript运行时的小型、简单、超快的web框架
文档 • TypeScript支持 • Cloudflare员工集成
Cloudflare代理
> 构建和部署基于人工智能的代理,通过工具调用自主执行任务
代理SDK文档 • 工具定义 • API 参考
开放遥测
> 用于收集跟踪、度量和日志的供应商中立可观察性框架
官方文件 • JS-SDK • 入门指南
模型上下文协议(MCP)
> AI应用程序无需外部服务即可访问工具和上下文的标准协议
MCP规范 • 实现 • 工具协议
本地监控痕迹
启动OTel TUI采集器,实时可视化轨迹:```bash
Install otel-tui (one time)
npm install -g @ymtdzzz/otel-tui
Run during development
otel-tui
这将显示以下所有跨度:
- 通过Hono的HTTP请求
- LLM对Cloudflare模型的推理调用
- 工具执行和结果
> 看 杜伊酒店 用于高级过滤和导出选项
## 环境配置
绑定在中定义 `wrangler.jsonc` 并通过键入 `worker-configuration.d.ts`:```ts
// src/index.ts
const app = new Hono<{ Bindings: CloudflareBindings }>()
> 环境与绑定指南
进一步阅读
- Cloudflare人工智能模型
- 耐用物品 (持续状态)
- 工人KV (用于缓存)
- D1数据库 (适用于结构化数据)
