Cloudflare Agent Tools Otel Template

Cloudflare AI代理与OpenTetry

一个自给自足的 Cloudflare Workers 模板特征：

• AI代理框架: Cloudflare代理 与当地 主控程序-样式工具（无需外部服务）
• Web框架: 荣誉 关于Cloudflare Workers的API
• 可观测性：已满 开放遥测 跟踪包括请求、LLM调用和工具使用
• 地方发展：OTel跟踪导出到 localhost:4318/v1/traces 随着 杜伊酒店 可视化

先决条件

• Cloudflare帐户: 每月5美元的带薪工人计划 （包括AI推理访问）
• 本地设置:

  npm install -g wrangler
  wrangler login

有关Cloudflare Workers的完整设置，请参阅： 入门指南

快速开始

npm install
npm run dev        # Start local dev server with hot reload

部署到Cloudflare：

npm run deploy

从Cloudflare配置同步类型：

npm run cf-typegen

看 wrangler命令参考 了解更多

项目结构

• src/index.ts：Hono应用程序入口点 CloudflareBindings
• src/sandbox-agent/：Cloudflare代理实施
• src/tools/：MCP风格的工具定义（本地，无外部服务）
• src/tests/：测试套件
• wrangler.jsonc：Worker配置和绑定

关键技术

Hono框架

一个适用于任何JavaScript运行时的小型、简单、超快的web框架

文档 • TypeScript支持 • Cloudflare员工集成

Cloudflare代理

构建和部署基于人工智能的代理，通过工具调用自主执行任务

代理SDK文档 • 工具定义 • API 参考

开放遥测

用于收集跟踪、度量和日志的供应商中立可观察性框架

模型上下文协议（MCP）

AI应用程序无需外部服务即可访问工具和上下文的标准协议

MCP规范 • 实现 • 工具协议

本地监控痕迹

启动OTel TUI采集器，实时可视化轨迹：

# 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:

// src/index.ts
const app = new Hono()

环境与绑定指南

进一步阅读

• Cloudflare人工智能模型
• 耐用物品 （持续状态）
• 工人KV （用于缓存）
• D1数据库 （适用于结构化数据）