fantasy

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

• 已安装 Go 工具链，go 命令可用
• 准备一个支持的模型供应商账号（README 示例用 OpenRouter）及其 API Key
• 一个可执行的 Go 项目（含 go.mod，用于引入 charm.land/fantasy）

安装与启动步骤

1. 1初始化 Go 项目

   新建目录并初始化 Go 模块，模块名随意。已有 Go 项目可跳过此步；这几步是按 Go 模块惯例推断，README 未给正式安装章节。

   go mod init myagent

   复制

2. 2引入 fantasy 依赖

   按 README 中的导入路径拉取框架本体；若使用 OpenRouter 供应商，一并拉取其子包。

   go get charm.land/fantasy
   go get charm.land/fantasy/providers/openrouter

   复制

3. 3准备 API Key

   到所选供应商处申请 API Key，后续以 openrouter.WithAPIKey(myHotKey) 的形式传入。建议从环境变量读取，不要硬编码。

4. 4创建 provider 与模型

   在 main.go 中导入 fantasy 和 providers/openrouter，先创建 provider，再用 LanguageModel 选定模型 ID。

   import "charm.land/fantasy"
   import "charm.land/fantasy/providers/openrouter"
   
   provider, err := openrouter.New(openrouter.WithAPIKey(myHotKey))
   if err != nil {
   	fmt.Fprintln(os.Stderr, "Whoops:", err)
   	os.Exit(1)
   }
   
   ctx := context.Background()
   
   model, err := provider.LanguageModel(ctx, "moonshotai/kimi-k2")
   if err != nil {
   	fmt.Fprintln(os.Stderr, "Dang:", err)
   	os.Exit(1)
   }

   复制

5. 5装配 Agent 与工具

   用 fantasy.NewAgentTool 定义工具，再用 fantasy.NewAgent 组合模型、系统提示和工具。示例中的 fetchCuteDogInfoFunc 需自己实现。

   cuteDogTool := fantasy.NewAgentTool(
     "cute_dog_tool",
     "Provide up-to-date info on cute dogs.",
     fetchCuteDogInfoFunc,
   )
   
   agent := fantasy.NewAgent(
     model,
     fantasy.WithSystemPrompt("You are a moderately helpful, dog-centric assistant."),
     fantasy.WithTools(cuteDogTool),
   )

   复制

6. 6编译并运行

   补全 prompt 与工具函数后运行程序，检查是否能正常拿到模型回复。Go 会编译为原生机器码，可直接部署单个二进制。

   go run .

   复制

关键配置

如何确认成功

go run . 编译无报错，openrouter.New 与 provider.LanguageModel 均未返回 err，Agent 能正常输出回复。

常见问题

注意事项

• README 节选未包含正式安装章节，go mod init / go get 命令是按 Go 模块惯例推断，请以官方文档为准。
• README 代码片段不完整，结尾的 prompt 内容与 fetchCuteDogInfoFunc 均未给出，需自行补全。
• API Key 属于敏感信息，不要硬编码或提交到版本库。