Agency：通往 AI 的 Go 之路

这是一个专为开发者设计的库，旨在通过简洁、高效且符合 Go 语言习惯的方式，探索大型语言模型（LLMs）及其他生成式 AI 的潜力。

欢迎来到 Agency！ 🕵️‍♂️

💻 快速入门

安装包：

go get github.com/neurocult/agency

聊天示例：

package main

import (
	"bufio"
	"context"
	"fmt"
	"os"

	_ "github.com/joho/godotenv/autoload"

	"github.com/neurocult/agency"
	"github.com/neurocult/agency/providers/openai"
)

func main() {
	assistant := openai.
		New(openai.Params{Key: os.Getenv("OPENAI_API_KEY")})
		.TextToText(openai.TextToTextParams{Model: "gpt-4o-mini"})
		.SetPrompt("你是一位乐于助人的助手。")

	messages := []agency.Message{}
	reader := bufio.NewReader(os.Stdin)
	ctx := context.Background()

	for {
		fmt.Print("用户：")

		text, err := reader.ReadString('\n')
		if err != nil {
			panic(err)
		}

		input := agency.NewTextMessage(agency.UserRole, text)
		answer, err := assistant.SetMessages(messages).Execute(ctx, input)
		if err != nil {
			panic(err)
		}

		fmt.Println("助手：", string(answer.Content()))

		messages = append(messages, input, answer)
	}
}

就是这样！

更多复杂用例，包括 RAG 和多模态操作，请参阅 examples。

🚀 特性

✨ 纯 Go 实现：速度快、轻量级、静态类型，无需纠结于 Python 或 JavaScript。

✨ 通过将业务逻辑与具体实现分离，编写 整洁代码 并遵循 整洁架构。

✨ 通过实现简单接口，轻松创建 自定义操作。

✨ 将操作 组合成流程，并通过 拦截器 观察每一步。

✨ OpenAI API 绑定（可用于任何兼容 OpenAI 的 API：文本到文本（完成）、文本到图像、文本到语音、语音到文本）。

🤔 为什么需要 Agency？

Agency 的核心愿景是赋能用户构建自主智能体。尽管它 适用于各种生成式 AI 应用场景，从聊天界面到复杂的数据分析，但我们的库最终目标是简化自主 AI 系统的开发。无论您是在构建单个助手，还是协调智能体群，Agency 都能提供所需的工具和灵活性，让您轻松高效地实现这些先进概念。

在生成式 AI 领域，基于 Go 的库并不多见。最著名的当属 LangChainGo，它是 Python LangChain 的 Go 版本。然而，将 Python 代码直接移植到 Go 中往往显得笨拙，且难以契合 Go 的语言习惯。此外，即使在 Python 生态中，LangChain 的设计也备受质疑。这一现状凸显了对符合 Go 语言风格的替代方案的迫切需求。

我们的目标正是填补这一空白，打造一个以 Go 为中心、强调简洁代码、避免不必要复杂性的库。Agency 拥有一个小巧而强大的核心，易于扩展，完美契合 Go 在静态类型和性能方面的优势。这是我们对生成式 AI 领域缺乏原生 Go 解决方案的回应。

教程

• 第 1 部分 (俄语翻译)

🛣 路线图

在接下来的版本中：

• 支持外部函数调用
• 元数据（使用的 token 数量、音频时长等）
• 更多提供商适配器，而不仅仅是 OpenAI
• 图像到文本操作
• 强大的自主智能体 API
• 标签和 JSON 输出解析器

Agency 快速上手指南

Agency 是一个专为 Go 开发者设计的 AI 库，旨在通过符合 Go 语言习惯（Idiomatic Go）的方式，轻松探索大语言模型（LLM）和生成式 AI 的潜力。它强调纯 Go 实现、类型安全以及清晰的架构设计。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux, macOS 或 Windows
• Go 版本：建议安装 Go 1.21 或更高版本
• API Key：您需要一个有效的 OpenAI API Key（或兼容 OpenAI 接口的其他服务商 Key）
• 环境变量：建议在项目根目录创建 .env 文件存储密钥，或在终端直接导出环境变量

export OPENAI_API_KEY="your-api-key-here"

安装步骤

使用 Go 模块命令安装 Agency 及其依赖：

go get github.com/neurocult/agency

如果您的项目中尚未初始化 Go 模块，请先运行 go mod init <module-name>。

基本使用

以下是一个最简单的对话机器人示例。该程序初始化一个 OpenAI 助手，并在命令行中与您进行多轮对话。

1. 创建文件 main.go
2. 粘贴以下代码
3. 运行 go run main.go

package main

import (
	"bufio"
	"context"
	"fmt"
	"os"

	_ "github.com/joho/godotenv/autoload"

	"github.com/neurocult/agency"
	"github.com/neurocult/agency/providers/openai"
)

func main() {
	// 初始化 OpenAI 提供者并配置模型
	assistant := openai.
		New(openai.Params{Key: os.Getenv("OPENAI_API_KEY")}).
		TextToText(openai.TextToTextParams{Model: "gpt-4o-mini"}).
		SetPrompt("You are helpful assistant.")

	messages := []agency.Message{}
	reader := bufio.NewReader(os.Stdin)
	ctx := context.Background()

	for {
		fmt.Print("User: ")

		text, err := reader.ReadString('\n')
		if err != nil {
			panic(err)
		}

		// 创建用户消息
		input := agency.NewTextMessage(agency.UserRole, text)
		
		// 执行请求并获取回答
		answer, err := assistant.SetMessages(messages).Execute(ctx, input)
		if err != nil {
			panic(err)
		}

		fmt.Println("Assistant:", string(answer.Content()))

		// 将对话历史加入上下文
		messages = append(messages, input, answer)
	}
}

说明：

• 代码使用了 godotenv 自动加载 .env 文件中的 OPENAI_API_KEY。
• messages 切片用于维护对话历史，确保多轮对话的连贯性。
• 更多复杂用例（如 RAG、多模态操作）可参考官方 examples 目录。