跳转至

示例目录

先按任务选择示例,再按语言查找。Go 参考示例和跨语言示例位于仓库 examples/ 目录;语言专属示例位于 language/<language>/examples/,会进入对应语言的 发现镜像仓库。十三个主题、三十种语言的覆盖矩阵见 语言覆盖矩阵。

按任务选择

任务 示例 说明
连接真实模型 真实模型 Golden Path 发布包、OpenAI-compatible 端点、一个 get_time 工具
连接其他 Provider 或 MCP Provider 与 MCP 演练、MCP 教程 发布包 Adapter、本地 MCP 客户端与 Transport 边界
托管 MCP 工具 language/python/examples/mcp, language/typescript/examples/mcp, language/csharp/examples/mcp, language/rust/examples/mcp, language/java/examples/mcp, language/ruby/examples/mcp, language/php/examples/mcp, language/elixir/examples/mcp, language/erlang/examples/mcp, language/lua/examples/mcp, language/r/examples/mcp, language/c/examples/mcp, language/cpp/examples/mcp, language/fortran/examples/mcp, language/cobol/examples/mcp 进程内或 stdio MCP 客户端;确定性工具发现与调用
增加 Provider fallback language/python/examples/provider-fallback、language/typescript/examples/provider-fallback、language/csharp/examples/provider-fallback、language/rust/examples/provider-fallback, language/ruby/examples/provider-fallback, language/php/examples/provider-fallback, language/c/examples/provider-fallback, language/cpp/examples/provider-fallback, language/fortran/examples/provider-fallback, language/elixir/examples/provider-fallback, language/erlang/examples/provider-fallback, language/lua/examples/provider-fallback, language/r/examples/provider-fallback, language/cobol/examples/provider-fallback, language/java/examples/provider-fallback 主模型失败后切换备用模型;确定性测试
重试模型调用 language/python/examples/retry, language/typescript/examples/retry, language/csharp/examples/retry, language/rust/examples/retry, language/java/examples/retry, language/ruby/examples/retry, language/php/examples/retry, language/c/examples/retry, language/cpp/examples/retry, language/fortran/examples/retry, language/elixir/examples/retry, language/erlang/examples/retry, language/lua/examples/retry, language/r/examples/retry, language/cobol/examples/retry 有界限的模型中间件仅重试可重试错误,并保留耗尽后的失败
观察 Agent 事件 language/python/examples/event-sink, language/typescript/examples/event-sink, language/csharp/examples/event-sink, language/rust/examples/event-sink, language/java/examples/event-sink, language/ruby/examples/event-sink, language/php/examples/event-sink, language/c/examples/event-sink, language/cpp/examples/event-sink, language/fortran/examples/event-sink, language/elixir/examples/event-sink, language/erlang/examples/event-sink, language/lua/examples/event-sink, language/r/examples/event-sink, language/cobol/examples/event-sink run.started、tool.call、run.completed 以及 FilterSink;确定性测试
流式输出 language/python/examples/streaming, language/typescript/examples/streaming, language/csharp/examples/streaming, language/rust/examples/streaming, language/ruby/examples/streaming, language/php/examples/streaming, language/c/examples/streaming, language/cpp/examples/streaming, language/fortran/examples/streaming, language/elixir/examples/streaming, language/erlang/examples/streaming, language/lua/examples/streaming, language/r/examples/streaming, language/cobol/examples/streaming, language/java/examples/streaming Delta 回调可重建最终输出;确定性 fake streaming model 测试
验证安装与拒绝路径 消费者 Starter 发布包安装与确定性 allow/deny 检查
生成受校验 JSON 结构化输出教程 Python、TypeScript、Java、C# 和 Rust 的 StructuredOutput 与确定性 fake-model 测试
校验结构化输出 language/python/examples/structured-output, language/typescript/examples/structured-output, language/csharp/examples/structured-output, language/rust/examples/structured-output, language/java/examples/structured-output, language/ruby/examples/structured-output, language/php/examples/structured-output, language/c/examples/structured-output, language/cpp/examples/structured-output, language/fortran/examples/structured-output, language/elixir/examples/structured-output, language/erlang/examples/structured-output, language/lua/examples/structured-output, language/r/examples/structured-output, language/cobol/examples/structured-output JSON Schema 校验;接受合法输出并拒绝非法输出
构建 Workspace Agent Workspace Agent 教程 使用发布包的只读 Go 应用
嵌入应用 应用嵌入清单 只读、有副作用、高风险部署的分档清单
通过 HTTP 运行 Core HTTP 嵌入服务教程、examples/embedded-service-auth、language/python/examples/service?language/python/examples/service-auth、language/typescript/examples/service、language/typescript/examples/service-auth、language/csharp/examples/service、language/rust/examples/service, language/java/examples/service, language/ruby/examples/service, language/php/examples/service, language/c/examples/service, language/cpp/examples/service, language/fortran/examples/service, language/elixir/examples/service, language/erlang/examples/service, language/lua/examples/service, language/r/examples/service, language/cobol/examples/service Go/Python/TypeScript/C#/Rust/Java 服务,以及 HMAC token 与租户策略变体
查看 Go 参考应用 examples/reference Go 参考应用
增加 Policy 与审批 examples/governed-workspace Go 受治理执行边界示例
执行身份与策略校验 language/python/examples/identity-policy, language/typescript/examples/identity-policy, language/csharp/examples/identity-policy, language/rust/examples/identity-policy, language/java/examples/identity-policy, language/ruby/examples/identity-policy, language/php/examples/identity-policy, language/c/examples/identity-policy, language/cpp/examples/identity-policy, language/fortran/examples/identity-policy, language/elixir/examples/identity-policy, language/erlang/examples/identity-policy, language/lua/examples/identity-policy, language/r/examples/identity-policy, language/cobol/examples/identity-policy 可信主体绑定、拒绝模型声称,并在副作用执行前拒绝
增加 Checkpoint examples/checkpoint Go Checkpoint 存储示例
持久化 Checkpoint language/python/examples/checkpoint, language/typescript/examples/checkpoint, language/csharp/examples/checkpoint, language/rust/examples/checkpoint, language/java/examples/checkpoint、language/ruby/examples/checkpoint、language/php/examples/checkpoint, language/c/examples/checkpoint, language/cpp/examples/checkpoint, language/fortran/examples/checkpoint, language/elixir/examples/checkpoint, language/erlang/examples/checkpoint, language/lua/examples/checkpoint, language/r/examples/checkpoint, language/cobol/examples/checkpoint 应用自有存储与 Allowlist 负载;最新记录往返和未注册类型拒绝
增加 Plugin examples/plugin Go 进程/WASM Plugin Host 示例
委派任务 examples/multiagent Go 本地委派示例
使用专题配方 examples/recipes Go Provider、事件、重试、VFS 等配方
集成生态组件 examples/ecosystem 可选 AxisVela Adapter 结构

示例与配方

  • examples/recipes 是 Go 为主的复制粘贴配方,并提供局部测试证据。
  • examples/ 是可运行项目,包括发布包和语言专属集成。

结构化输出、Checkpoint 存储、身份、VFS 隔离和长时操作等主题会同时出现在两种形式中。 配方用于理解机制,示例用于应用形态集成;不要把两者同时复制进一个项目。

按语言选择

语言 示例
Go examples/
Python language/python/examples
TypeScript language/typescript/examples
Java language/java/examples
C# language/csharp/examples
Rust language/rust/examples
Ruby language/ruby/examples
PHP language/php/examples
C language/c/examples
C++ language/cpp/examples
Fortran language/fortran/examples
Erlang language/erlang/examples
R language/r/examples
COBOL language/cobol/examples
Elixir language/elixir/examples
Lua language/lua/examples

每个语言示例目录都有自己的 README,包含安装和运行命令。每个 Core 语言都包含 consumer 和 live-model 入口;hitl 和 session-checkpoint 仅在语言声明 支持时提供,明确的不适用列表见语言覆盖矩阵。 Python、TypeScript、Java、Rust、C# 等 Core 实现独立版本化;当前支持范围见 语言总表。

组织方式

  • examples/ 放置 Go 参考示例和跨语言集成。
  • language/<language>/examples/ 放置语言专属可运行示例。
  • 语言示例会复制到对应发现镜像仓库。
  • 使用已发布包的示例不要求检出仓库或替换本地包。

示例不是生产安全 Profile。身份、持久审批、效果对账和隔离仍由应用负责。