examples

package

v0.35.0 Latest Latest Go to latest Published: Dec 29, 2025 License: MIT Imports: 5 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/astercloud/aster

Links

Open Source Insights

Documentation ¶

Overview ¶

Package examples 包含 Aster 框架的示例代码和集成演示。

Index ¶

func AdvancedSummarizationExample()
func AgentMemoryExample()
func BestPractices()
func MonitoringExample(summarizationMW *middleware.SummarizationMiddleware)
func Phase4IntegrationExample() error

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func AdvancedSummarizationExample ¶

func AdvancedSummarizationExample()

AdvancedSummarizationExample 展示高级总结策略

func AgentMemoryExample ¶

func AgentMemoryExample()

AgentMemoryExample 展示如何管理 Agent 记忆

func BestPractices ¶

func BestPractices()

BestPractices 最佳实践指南

func MonitoringExample ¶

func MonitoringExample(summarizationMW *middleware.SummarizationMiddleware)

MonitoringExample 展示如何监控中间件性能

func Phase4IntegrationExample ¶

func Phase4IntegrationExample() error

Phase4IntegrationExample 展示如何集成 SummarizationMiddleware 和 AgentMemoryMiddleware

Types ¶

This section is empty.

Source Files ¶

View all Source files

phase4_integration.go

Directories ¶

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL

Path	Synopsis
a2a A2A 演示 Agent-to-Agent 协议实现，包括基于 JSON-RPC 的消息发送、任务管理和对话历史追踪。	A2A 演示 Agent-to-Agent 协议实现，包括基于 JSON-RPC 的消息发送、任务管理和对话历史追踪。
actor Actor 演示如何使用 Actor 模型实现多 Agent 协作，包括 Ping-Pong、并发计数器、监督者策略、流水线处理和广播消息等模式。	Actor 演示如何使用 Actor 模型实现多 Agent 协作，包括 Ping-Pong、并发计数器、监督者策略、流水线处理和广播消息等模式。
agent Agent 演示核心 Agent API，包括工具注册、事件订阅和多轮对话能力。	Agent 演示核心 Agent API，包括工具注册、事件订阅和多轮对话能力。
agent-working-memory AgentWorkingMemory 演示带 Working Memory 的 Agent，支持自动加载到 system prompt、LLM 主动更新和跨会话持久化。	AgentWorkingMemory 演示带 Working Memory 的 Agent，支持自动加载到 system prompt、LLM 主动更新和跨会话持久化。
asteros
basic command Basic 演示 AsterOS 统一运行时系统的基本用法，包括 Agent 注册、启动和优雅关闭等核心功能。	Basic 演示 AsterOS 统一运行时系统的基本用法，包括 Agent 注册、启动和优雅关闭等核心功能。
with_interfaces command WithInterfaces 演示 AsterOS 与多种接口的集成，展示如何配置和使用不同的输入输出接口。	WithInterfaces 演示 AsterOS 与多种接口的集成，展示如何配置和使用不同的输入输出接口。
cloud-sandbox CloudSandbox 演示云端沙箱环境的使用，支持阿里云 AgentBay 和火山引擎两种云平台的代码执行隔离环境。	CloudSandbox 演示云端沙箱环境的使用，支持阿里云 AgentBay 和火山引擎两种云平台的代码执行隔离环境。
comprehensive Comprehensive 演示多个 Aster 功能的综合应用，包括防护栏集成、带条件分支和并行步骤的复杂工作流编排，以及 WorkflowAgent 智能调度。	Comprehensive 演示多个 Aster 功能的综合应用，包括防护栏集成、带条件分支和并行步骤的复杂工作流编排，以及 WorkflowAgent 智能调度。
config-paths Config 演示跨平台路径管理，支持 macOS、Linux 和 Windows。	Config 演示跨平台路径管理，支持 macOS、Linux 和 Windows。
custom_claude_api
desktop Example: Desktop Application with Wails/Tauri/Electron	Example: Desktop Application with Wails/Tauri/Electron
evals Evals 演示无外部依赖的模型输出评估功能，包括关键词覆盖率评估和词汇级相似度 (Jaccard) 评估。	Evals 演示无外部依赖的模型输出评估功能，包括关键词覆盖率评估和词汇级相似度 (Jaccard) 评估。
evals-session EvalsSession 演示将 Session 事件与评估系统结合，通过 BuildTextEvalInputFromEvents 转换会话事件并进行关键词覆盖率和词汇相似度评估。	EvalsSession 演示将 Session 事件与评估系统结合，通过 BuildTextEvalInputFromEvents 转换会话事件并进行关键词覆盖率和词汇相似度评估。
execution-plan execution-plan example demonstrates how to use ExecutionPlan functionality to generate, review, and execute multi-step plans with user approval.	execution-plan example demonstrates how to use ExecutionPlan functionality to generate, review, and execute multi-step plans with user approval.
guardrails Guardrails 演示安全防护栏系统，包括 PII 检测、PII 掩码、提示注入检测、防护栏链和 OpenAI 内容审核集成。	Guardrails 演示安全防护栏系统，包括 PII 检测、PII 掩码、提示注入检测、防护栏链和 OpenAI 内容审核集成。
human-in-the-loop HumanInTheLoop 演示 HITL 中间件实现的工具审批工作流，包括基于风险的评估、交互式提示和可配置的审批策略。	HumanInTheLoop 演示 HITL 中间件实现的工具审批工作流，包括基于风险的评估、交互式提示和可配置的审批策略。
logging Logging 演示日志系统的使用，包括 StdoutTransport 和 FileTransport 两种输出方式，支持 JSON 行格式日志输出。	Logging 演示日志系统的使用，包括 StdoutTransport 和 FileTransport 两种输出方式，支持 JSON 行格式日志输出。
logic-memory Package main demonstrates the Logic Memory framework for Aster SDK.	Package main demonstrates the Logic Memory framework for Aster SDK.
long-running-tools LongRunningTools 演示长时运行工具的使用，包括异步执行、进度跟踪、任务取消和并发多任务处理。	LongRunningTools 演示长时运行工具的使用，包括异步执行、进度跟踪、任务取消和并发多任务处理。
mcp MCP 演示与 Model Context Protocol 服务器的集成，展示如何连接外部工具服务器并将 MCP 工具与内置工具配合使用。	MCP 演示与 Model Context Protocol 服务器的集成，展示如何连接外部工具服务器并将 MCP 工具与内置工具配合使用。
server command Server 演示如何使用 pkg/mcpserver 暴露 MCP HTTP Server，支持 tools/list 和 tools/call，提供一个 echo 工具供客户端调用。	Server 演示如何使用 pkg/mcpserver 暴露 MCP HTTP Server，支持 tools/list 和 tools/call，提供一个 echo 工具供客户端调用。
memory Memory 演示 AgentMemoryMiddleware 提供的长期记忆能力，使用基于文件的存储和 grep 风格的搜索。	Memory 演示 AgentMemoryMiddleware 提供的长期记忆能力，使用基于文件的存储和 grep 风格的搜索。
memory-advanced MemoryAdvanced 演示基于 memory.Scope 的高级记忆封装策略，支持多用户、多项目、多资源的分层记忆管理，无需 LLM 直接操作文件路径。	MemoryAdvanced 演示基于 memory.Scope 的高级记忆封装策略，支持多用户、多项目、多资源的分层记忆管理，无需 LLM 直接操作文件路径。
memory-agent MemoryAgent 演示带长期记忆的 Agent，使用 FilesystemMiddleware 和 AgentMemoryMiddleware 实现跨会话的用户信息记忆和检索。	MemoryAgent 演示带长期记忆的 Agent，使用 FilesystemMiddleware 和 AgentMemoryMiddleware 实现跨会话的用户信息记忆和检索。
memory-semantic MemorySemantic 演示 SemanticMemory 的语义检索能力，使用内存 VectorStore 和 MockEmbedder 实现基础的向量相似度搜索。	MemorySemantic 演示 SemanticMemory 的语义检索能力，使用内存 VectorStore 和 MockEmbedder 实现基础的向量相似度搜索。
memory-semantic-session MemorySemanticSession 演示如何将 Session 对话内容保存到 SemanticMemory，实现跨会话的长期语义记忆和检索能力。	MemorySemanticSession 演示如何将 Session 对话内容保存到 SemanticMemory，实现跨会话的长期语义记忆和检索能力。
memory-working MemoryWorking 演示 Working Memory 的跨会话状态管理功能。	MemoryWorking 演示 Working Memory 的跨会话状态管理功能。
model-fallback ModelFallback 演示模型降级策略，当主模型不可用时自动切换到备选模型。	ModelFallback 演示模型降级策略，当主模型不可用时自动切换到备选模型。
openrouter OpenRouter 演示如何使用 OpenRouter 作为 LLM Provider，支持多模型切换和统一的 API 访问方式。	OpenRouter 演示如何使用 OpenRouter 作为 LLM Provider，支持多模型切换和统一的 API 访问方式。
permission Permission 演示权限系统的三种模式：auto_approve、smart_approve 和 always_ask。	Permission 演示权限系统的三种模式：auto_approve、smart_approve 和 always_ask。
plan-explore-ui PlanExploreUI 演示一个简单的 Plan/Explore 命令行 UI，使用 TodoWrite、 Task、Read、Grep 等工具分析代码，并通过事件订阅渲染工具调用过程。	PlanExploreUI 演示一个简单的 Plan/Explore 命令行 UI，使用 TodoWrite、 Task、Read、Grep 等工具分析代码，并通过事件订阅渲染工具调用过程。
prompt-builder Package main 演示如何使用 Prompt 压缩功能	Package main 演示如何使用 Prompt 压缩功能
ptc
basic command
file-processor command
local-test command
rag-basic RAGBasic 演示最小化的 RAG 检索增强生成示例，使用核心管线、内存向量库和 MockEmbedder 实现文档入库和语义检索。	RAGBasic 演示最小化的 RAG 检索增强生成示例，使用核心管线、内存向量库和 MockEmbedder 实现文档入库和语义检索。
reasoning Reasoning 演示推理中间件的高级推理能力，支持分步骤的问题分解、系统化分析和结构化推理输出。	Reasoning 演示推理中间件的高级推理能力，支持分步骤的问题分解、系统化分析和结构化推理输出。
recipe Recipe 演示声明式 Agent 配置系统，通过 YAML 文件定义可复用的 Agent 模板。	Recipe 演示声明式 Agent 配置系统，通过 YAML 文件定义可复用的 Agent 模板。
router Router 演示 StaticRouter 的模型路由功能，根据不同的 routing_profile 为 Agent 选择不同的模型配置，如 "quality-first" 或 "cost-first"。	Router 演示 StaticRouter 的模型路由功能，根据不同的 routing_profile 为 Agent 选择不同的模型配置，如 "quality-first" 或 "cost-first"。
sandbox-permission Package main demonstrates the Claude Agent SDK style sandbox and permission system.	Package main demonstrates the Claude Agent SDK style sandbox and permission system.
scheduler Scheduler 演示任务调度器功能，包括步骤触发、时间间隔触发、步骤监听器、多任务调度、任务取消和触发回调监控。	Scheduler 演示任务调度器功能，包括步骤触发、时间间隔触发、步骤监听器、多任务调度、任务取消和触发回调监控。
server-http ServerHTTP 演示如何使用 pkg/server 暴露 HTTP Chat 接口，提供 POST /v1/agents/chat 端点用于与 Agent 进行对话交互。	ServerHTTP 演示如何使用 pkg/server 暴露 HTTP Chat 接口，提供 POST /v1/agents/chat 端点用于与 Agent 进行对话交互。
session Session 演示会话管理系统，包括分层状态管理、事件溯源、事件过滤和会话列表。	Session 演示会话管理系统，包括分层状态管理、事件溯源、事件过滤和会话列表。
session-enhanced SessionEnhanced 演示增强版会话管理功能，包括与 Agent 的深度集成、会话状态持久化和多轮对话上下文管理。	SessionEnhanced 演示增强版会话管理功能，包括与 Agent 的深度集成、会话状态持久化和多轮对话上下文管理。
session-mysql SessionMySQL 演示 MySQL 8.0+ Session 持久化功能，利用 MySQL 的 JSON 列类型实现会话状态和事件的持久化存储。	SessionMySQL 演示 MySQL 8.0+ Session 持久化功能，利用 MySQL 的 JSON 列类型实现会话状态和事件的持久化存储。
session-postgres SessionPostgres 演示 PostgreSQL Session 持久化功能，使用 JSONB 列类型实现高效的会话状态和事件存储。	SessionPostgres 演示 PostgreSQL Session 持久化功能，使用 JSONB 列类型实现高效的会话状态和事件存储。
session-sqlite Session-SQLite 演示 SQLite 会话存储，适用于桌面应用和单机场景。	Session-SQLite 演示 SQLite 会话存储，适用于桌面应用和单机场景。
simple Simple 演示 Aster Agent SDK 的基础组件，包括 EventBus 事件总线、 Sandbox 沙箱执行环境和 JSON Store 持久化存储。	Simple 演示 Aster Agent SDK 的基础组件，包括 EventBus 事件总线、 Sandbox 沙箱执行环境和 JSON Store 持久化存储。
skills Skills 演示 Agent 技能系统的使用，支持通过命令行参数配置工作目录和调试模式。	Skills 演示 Agent 技能系统的使用，支持通过命令行参数配置工作目录和调试模式。
streaming Streaming 演示基于 Go 1.23 iter.Seq2 迭代器的 Agent 流式 API，包括事件收集、过滤和内存高效的实时处理。	Streaming 演示基于 Go 1.23 iter.Seq2 迭代器的 Agent 流式 API，包括事件收集、过滤和内存高效的实时处理。
structured-output StructuredOutput 演示结构化输出功能，包括 JSON Schema 生成、类型化解析、字段验证和自定义验证逻辑。	StructuredOutput 演示结构化输出功能，包括 JSON Schema 生成、类型化解析、字段验证和自定义验证逻辑。
subagent Subagent 演示 SubAgentMiddleware 实现的任务委派功能，支持将任务分派给专业化的子代理如研究员、编码员和审查员等角色。	Subagent 演示 SubAgentMiddleware 实现的任务委派功能，支持将任务分派给专业化的子代理如研究员、编码员和审查员等角色。
subagent-async SubagentAsync 演示 SubAgent 的异步执行模式，支持并行委派任务给多个专业化子代理并收集结果。	SubagentAsync 演示 SubAgent 的异步执行模式，支持并行委派任务给多个专业化子代理并收集结果。
telemetry Telemetry 演示 OpenTelemetry 集成，包括基础追踪、Agent 执行追踪、 LLM 调用追踪、工具执行追踪和分布式追踪上下文传播。	Telemetry 演示 OpenTelemetry 集成，包括基础追踪、Agent 执行追踪、 LLM 调用追踪、工具执行追踪和分布式追踪上下文传播。
tool-cache ToolCache 演示工具执行结果缓存功能，通过缓存耗时工具的输出来提升性能。	ToolCache 演示工具执行结果缓存功能，通过缓存耗时工具的输出来提升性能。
workflow Workflow 演示 Aster 工作流引擎，包括顺序步骤执行、步骤间数据传递和基于流的事件处理。	Workflow 演示 Aster 工作流引擎，包括顺序步骤执行、步骤间数据传递和基于流的事件处理。
workflow-agents WorkflowAgents 演示工作流 Agent 的使用，包括 SequentialAgent 顺序工作流、 ParallelAgent 并行工作流和 LoopAgent 循环工作流等模式。	WorkflowAgents 演示工作流 Agent 的使用，包括 SequentialAgent 顺序工作流、 ParallelAgent 并行工作流和 LoopAgent 循环工作流等模式。
workflow-semantic WorkflowSemantic 演示如何在 Workflow Agent 中集成 SemanticMemory，实现跨步骤的语义记忆共享和上下文感知的工作流执行。	WorkflowSemantic 演示如何在 Workflow Agent 中集成 SemanticMemory，实现跨步骤的语义记忆共享和上下文感知的工作流执行。
workflow_complete WorkflowComplete 演示 Aster Workflow 的完整功能测试，包括基础工作流、所有步骤类型、嵌套工作流和错误处理等场景。	WorkflowComplete 演示 Aster Workflow 的完整功能测试，包括基础工作流、所有步骤类型、嵌套工作流和错误处理等场景。
workflow_router WorkflowRouter 演示 Router 步骤的流式执行，支持基于输入内容动态选择执行路径。	WorkflowRouter 演示 Router 步骤的流式执行，支持基于输入内容动态选择执行路径。
workflow_steps WorkflowSteps 演示 Aster Workflow 的所有步骤类型，包括 FunctionStep、 ConditionStep、ParallelStep、LoopStep、RouterStep 等。	WorkflowSteps 演示 Aster Workflow 的所有步骤类型，包括 FunctionStep、 ConditionStep、ParallelStep、LoopStep、RouterStep 等。