Eino 扩展

英语 | 中文

概述

EinoExt 项目托管了针对 Eino 框架的各种扩展。Eino 框架是一个功能强大且灵活的框架，用于构建大语言模型应用。这些扩展包括：

• 组件实现：Eino 各组件类型的官方实现。

组件类型	官方实现
对话模型	OpenAI、Claude、Gemini、Ark、Ollama...
工具	Google 搜索、Duck Duck Go...
检索器	Elastic Search、Volc VikingDB...
对话模板	DefaultChatTemplate...
文档加载器	WebURL、Amazon S3、文件...
文档转换器	HTMLSplitter、ScoreReranker...
索引器	Elastic Search、Volc VikingDB...
嵌入	OpenAI、Ark...
Lambda	JSONMessageParser...

有关组件类型的更多详细信息，请参阅 Eino 组件文档。

有关组件实现的更多详细信息，请参阅 Eino 生态系统文档。

• 回调处理器：实现了 Eino 的 CallbackHandler 接口的官方回调处理器，例如 Langfuse 跟踪 回调。
• DevOps 工具：适用于 Eino 的 IDE 插件，支持可视化调试、基于 UI 的图编辑等功能。更多详情请参阅 Eino Dev 工具文档。

安全性

如果您在此项目中发现潜在的安全问题，或认为可能发现了安全问题，请通过我们的 安全中心 或 漏洞报告邮箱 通知字节跳动安全团队。

请不要创建公开的 GitHub 问题。

许可证

本项目采用 Apache-2.0 许可证 许可。

Eino-ext 快速上手指南

环境准备

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

• 操作系统：Linux, macOS 或 Windows
• Go 版本：Go 1.21 或更高版本
• 依赖管理：已安装并配置好 Go Modules
• 基础框架：建议先了解 Eino 核心框架的基本概念

安装步骤

通过 Go Modules 将 eino-ext 添加到您的项目中。您可以根据需要安装特定的扩展组件。

初始化项目（如尚未初始化）

go mod init your-project-name

安装核心扩展包

go get github.com/cloudwego/eino-ext/components/model/openai
go get github.com/cloudwego/eino-ext/components/tool/googlesearch
go get github.com/cloudwego/eino-ext/callbacks/langfuse

提示：您可以按需替换上述命令中的具体组件路径（如 ark, ollama, volc-vikingdb 等），以适配不同的服务商。国内开发者若使用字节火山引擎相关服务（如 Ark, VikingDB），可直接引用对应的 volcengine 路径包，网络连接更稳定。

基本使用

以下是一个最简单的示例，展示如何使用 eino-ext 中的 OpenAI ChatModel 组件构建一个聊天应用。

代码示例

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/cloudwego/eino/components/model"
	openai "github.com/cloudwego/eino-ext/components/model/openai"
	"github.com/cloudwego/eino/schema"
)

func main() {
	ctx := context.Background()

	// 初始化 OpenAI ChatModel
	chatModel, err := openai.NewChatModel(ctx, &openai.Config{
		APIKey: "YOUR_OPENAI_API_KEY",
		Model:  "gpt-3.5-turbo",
	})
	if err != nil {
		log.Fatalf("failed to create chat model: %v", err)
	}

	// 构造消息
	messages := []*schema.Message{
		schema.UserMessage("你好，请介绍一下你自己。"),
	}

	// 调用模型生成回复
	resp, err := chatModel.Generate(ctx, messages)
	if err != nil {
		log.Fatalf("failed to generate response: %v", err)
	}

	fmt.Printf("AI 回复：%s\n", resp.Content)
}

运行程序

go run main.go

运行成功后，您将看到来自 LLM 的文本回复。您可以参考 Eino 组件文档 探索更多组件（如 RAG 检索器、文档加载器等）的组合用法。