examples/

directory
v0.7.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 9, 2025 License: Apache-2.0

README

GoAgent Examples

This directory contains examples demonstrating the agent framework capabilities, organized by complexity level.

Structure

basic/ - Single-Feature Examples

Simple, focused examples demonstrating individual features:

  • Simple agent creation
  • Tool usage
  • Chain construction
  • Agent with memory
  • Ollama integration
  • Provider consistency
  • All supported providers
  • Smart Agent with Tools (NEW) - Time retrieval and API calls

Best for: First-time users, learning basics

advanced/ - Multi-Feature Examples

Examples combining multiple features:

  • Streaming execution
  • Multi-mode streaming
  • Observability integration
  • ReAct agents
  • Parallel execution
  • Tool runtime
  • Tool selector

Best for: Intermediate users, production patterns

integration/ - Full-System Examples

Complete system integration examples:

  • LangChain-inspired workflows
  • Multi-agent systems
  • Human-in-the-loop
  • Pre-configured agents

Best for: Advanced users, architecture reference

Running Examples

# Navigate to example directory
cd examples/basic/01-simple-agent/

# Run example
go run simple_agent.go

Prerequisites

  • Go 1.25.0+
  • Required dependencies installed (go mod download)
  • Environment variables configured (if needed)

Directories

Path Synopsis
multi-agent-collaboration command
multi-agent-demo command
multi-agent-modular command
multi-agent-modular/agents
multi-agent-simple command
multi-mode-streaming command
multiagent-patterns command
observability command
parallel-execution command
pool-decoupled-architecture command
react command
streaming command
supervisor_agent command
supervisor_agent/features
tool-runtime command
tool-selector command
agents
react_generator command
basic
01-simple-agent command
02-tools command
03-agent-with-memory command
04-ollama-agent command
05-provider-consistency command
06-all-providers command
07-smart-agent-with-tools command
08-deepseek-agent command
Package main demonstrates using DeepSeek LLM provider with GoAgent
 Package main demonstrates using DeepSeek LLM provider with GoAgent
09-deepseek-simple command
Package main demonstrates a simple DeepSeek agent implementation
 Package main demonstrates a simple DeepSeek agent implementation
09-deepseek-simple/invokefast command
Package main demonstrates DeepSeek usage with GoAgent's InvokeFast optimization
 Package main demonstrates DeepSeek usage with GoAgent's InvokeFast optimization
10-object-pooling command
Package main demonstrates the usage of GoAgent's object pooling for GC pressure reduction
 Package main demonstrates the usage of GoAgent's object pooling for GC pressure reduction
11-deepseek-with-builder command
Package main demonstrates using DeepSeek LLM with AgentBuilder
 Package main demonstrates using DeepSeek LLM with AgentBuilder
12-deepseek-simple command
Package main demonstrates simplified DeepSeek Agent usage
 Package main demonstrates simplified DeepSeek Agent usage
13-simple-builder-deepseek command
Package main 演示使用简化的 Builder API 构建 DeepSeek Agent
 Package main 演示使用简化的 Builder API 构建 DeepSeek Agent
14-reasoning-agents command
Package main 演示使用 builder 包快速创建各种推理型 Agent
 Package main 演示使用 builder 包快速创建各种推理型 Agent
15-simple-builder-kimi command
Package main 演示使用简化的 Builder API 构建 Kimi Agent
 Package main 演示使用简化的 Builder API 构建 Kimi Agent
16-pdf-rag command
Package main 演示使用 PDF 文档构建 RAG（检索增强生成）系统
 Package main 演示使用 PDF 文档构建 RAG（检索增强生成）系统
17-vertexai-rag command
Package main 演示使用 Vertex AI（Gemini）构建 RAG 系统
 Package main 演示使用 Vertex AI（Gemini）构建 RAG 系统
builder
advanced command
Advanced API 示例 展示 Builder API 的 Advanced 层级（30+ 个方法，覆盖 100% 使用场景）
 Advanced API 示例 展示 Builder API 的 Advanced 层级（30+ 个方法，覆盖 100% 使用场景）
core command
Core API 示例 展示 Builder API 的 Core 层级（15-20 个方法，覆盖 95% 使用场景）
 Core API 示例 展示 Builder API 的 Core 层级（15-20 个方法，覆盖 95% 使用场景）
serialization command
simple command
Simple API 示例 展示 Builder API 的 Simple 层级（5-8 个方法，覆盖 80% 使用场景）
 Simple API 示例 展示 Builder API 的 Simple 层级（5-8 个方法，覆盖 80% 使用场景）
Package main 综合示例 - GoAgent 框架组件完整性验证
 Package main 综合示例 - GoAgent 框架组件完整性验证
generator
advanced command
basic command
integration
human-in-loop command
langchain-complete command
langchain-inspired command
langchain-phase1 command
langchain-phase2 command
multiagent command
multiagent-nats command
preconfig-agents command
Package main 演示智能运维 Agent 分层治理体系
 Package main 演示智能运维 Agent 分层治理体系
llm
advanced command
Package main 演示 LLM 包的高级用法
 Package main 演示 LLM 包的高级用法
anthropic command
cohere command
huggingface command
kimi command
mcp
basic_tools command
Package main 演示 MCP 工具箱的基础功能
 Package main 演示 MCP 工具箱的基础功能
custom_tool command
Package main 演示如何创建自定义 MCP 工具
 Package main 演示如何创建自定义 MCP 工具
tool_chain command
Package main 演示 MCP 工具链编排功能
 Package main 演示 MCP 工具链编排功能
multiagent
01-basic-system command
Package main 演示 MultiAgentSystem 的基本用法 本示例展示如何创建多智能体系统、注册 Agent、发送消息和执行协作任务
 Package main 演示 MultiAgentSystem 的基本用法 本示例展示如何创建多智能体系统、注册 Agent、发送消息和执行协作任务
02-collaboration-types command
Package main 演示不同的多智能体协作类型 本示例展示五种协作模式：并行、顺序、分层、共识、管道
 Package main 演示不同的多智能体协作类型 本示例展示五种协作模式：并行、顺序、分层、共识、管道
03-team-management command
Package main 演示多智能体团队管理功能 本示例展示如何创建团队、分配角色、管理团队成员
 Package main 演示多智能体团队管理功能 本示例展示如何创建团队、分配角色、管理团队成员
04-specialized-agents command
Package main 演示专业化 Agent 的使用 本示例展示 SpecializedAgent 和 NegotiatingAgent 的高级用法
 Package main 演示专业化 Agent 的使用 本示例展示 SpecializedAgent 和 NegotiatingAgent 的高级用法
05-llm-collaborative-agents command
Package main 演示使用 LLM 的多智能体协作系统 本示例展示如何创建具有 LLM 推理能力的协作 Agent
 Package main 演示使用 LLM 的多智能体协作系统 本示例展示如何创建具有 LLM 推理能力的协作 Agent
06-llm-tool-calling command
Package main 演示如何在 MultiAgent 系统中使用 LLM 调用工具
 Package main 演示如何在 MultiAgent 系统中使用 LLM 调用工具
07-multiagent-llm-stream command
Package main 演示多智能体系统中使用 LLM 流式响应
 Package main 演示多智能体系统中使用 LLM 流式响应
08-multiagent-tool-registry command
Package main 演示多智能体系统中使用工具注册表
 Package main 演示多智能体系统中使用工具注册表
09-multiagent-with-middleware command
Package main 演示多智能体系统中使用工具中间件
 Package main 演示多智能体系统中使用工具中间件
10-multiagent-integrated command
Package main 演示多智能体系统综合使用 LLM、工具注册表、中间件和记忆
 Package main 演示多智能体系统综合使用 LLM、工具注册表、中间件和记忆
11-planning-multiagent command
Package main 演示多智能体系统与规划模块的集成使用
 Package main 演示多智能体系统与规划模块的集成使用
12-structured-planning command
common
Package common 提供 multiagent 示例的公共组件
 Package common 提供 multiagent 示例的公共组件
optimization
02-cache-presets command
cot_vs_react command
hybrid_mode command
planning_execution command
Package main demonstrates InvokeFast performance optimization
 Package main demonstrates InvokeFast performance optimization
Package main 演示 Planning 包的使用
 Package main 演示 Planning 包的使用
skills
01-demo command
Package main 演示多技能协作系统
 Package main 演示多技能协作系统
02-weather-skill command
Package main 天气技能示例
 Package main 天气技能示例
02-weather-skill/internal/config
Package config 配置结构定义
 Package config 配置结构定义
02-weather-skill/internal/handler
Package handler 请求处理层
 Package handler 请求处理层
02-weather-skill/internal/llmtools
Package llmtools LLM 工具定义
 Package llmtools LLM 工具定义
02-weather-skill/internal/logic
Package logic 业务逻辑层
 Package logic 业务逻辑层
02-weather-skill/internal/skill
Package skill LLM 天气技能实现
 Package skill LLM 天气技能实现
02-weather-skill/internal/svc
Package svc 服务依赖容器
 Package svc 服务依赖容器
02-weather-skill/internal/types
Package types 数据结构定义
 Package types 数据结构定义
tools
01-calculator command
Package main 演示计算器工具的使用方法 本示例展示 CalculatorTool 和 AdvancedCalculatorTool 的基本用法
 Package main 演示计算器工具的使用方法 本示例展示 CalculatorTool 和 AdvancedCalculatorTool 的基本用法
02-http-api command
Package main 演示 HTTP API 工具的使用方法 本示例展示 APITool 的基本用法，包括 GET、POST 请求和 Builder 模式
 Package main 演示 HTTP API 工具的使用方法 本示例展示 APITool 的基本用法，包括 GET、POST 请求和 Builder 模式
03-shell command
Package main 演示 Shell 工具的使用方法 本示例展示 ShellTool 的基本用法，包括白名单机制和安全执行
 Package main 演示 Shell 工具的使用方法 本示例展示 ShellTool 的基本用法，包括白名单机制和安全执行
04-search command
Package main 演示搜索工具的使用方法 本示例展示 SearchTool 的基本用法，包括模拟搜索引擎和聚合搜索
 Package main 演示搜索工具的使用方法 本示例展示 SearchTool 的基本用法，包括模拟搜索引擎和聚合搜索
05-file-operations command
Package main 演示文件操作工具的使用方法 本示例展示专门化文件工具的基本用法
 Package main 演示文件操作工具的使用方法 本示例展示专门化文件工具的基本用法
06-web-scraper command
Package main 演示网页抓取工具的使用方法 本示例展示 WebScraperTool 的基本用法
 Package main 演示网页抓取工具的使用方法 本示例展示 WebScraperTool 的基本用法
07-function-tool command
Package main 演示自定义函数工具的使用方法 本示例展示如何使用 FunctionTool 和 FunctionToolBuilder 创建自定义工具
 Package main 演示自定义函数工具的使用方法 本示例展示如何使用 FunctionTool 和 FunctionToolBuilder 创建自定义工具
08-tool-with-agent command
Package main 演示工具与 Agent 集成的使用方法 本示例展示如何将工具集成到 Agent 中进行自动调用
 Package main 演示工具与 Agent 集成的使用方法 本示例展示如何将工具集成到 Agent 中进行自动调用
middleware command
Package main 演示中间件与可观测性功能
 Package main 演示中间件与可观测性功能
registry command
Package main 演示工具注册表和执行器的使用
 Package main 演示工具注册表和执行器的使用
interactive command

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.