通过官方 SDK 在代码中直接调用记忆服务，类型安全，适合后端服务集成。当前提供 Go SDK，其他语言 SDK 持续规划中。
\n| 信息 | \n值 | \n
|---|---|
| API Base URL | \nhttps://cloud.memory.bj.baidubce.com/api | \n
| API Key | \n在控制台\"API Key\"页签中创建 | \n
| Bank ID | \n在控制台创建记忆库时设定 | \n
\n\nAPI Base URL 已包含
\n/api，不要再额外拼接。
1go get github.com/baidubce/bce-sdk-go/services/cloudmemory/api1import (\n2 "context"\n3 cloudmemory "github.com/baidubce/bce-sdk-go/services/cloudmemory/api"\n4)\n5\n6// 使用 API Base URL 和 API Key 创建客户端\n7client := cloudmemory.New("https://cloud.memory.bj.baidubce.com/api", "<YOUR_API_KEY>")\n8\n9// 或带超时\n10client = cloudmemory.NewWithTimeout("https://cloud.memory.bj.baidubce.com/api", "<YOUR_API_KEY>", 2*time.Minute)1items := []cloudmemory.MemoryItem{\n2 *cloudmemory.NewMemoryItem("用户偏好使用 TypeScript 构建 API 服务。"),\n3}\n4out, err := client.Retain(ctx, "<YOUR_BANK_ID>", *cloudmemory.NewRetainRequest(items))追加内容到已有文档：
\n\n1item := cloudmemory.NewMemoryItem("团队决定将状态管理从 Redux 迁移到 Zustand。")\n2item.DocumentId = stringPtr("onboarding-session-001")\n3item.UpdateMode = stringPtr("append")\n4items := []cloudmemory.MemoryItem{*item}\n5out, err := client.Retain(ctx, "<YOUR_BANK_ID>", *cloudmemory.NewRetainRequest(items))1out, err := client.Recall(ctx, "<YOUR_BANK_ID>",\n2 *cloudmemory.NewRecallRequest("用户偏好的技术栈是什么？"))1out, err := client.Reflect(ctx, "<YOUR_BANK_ID>",\n2 *cloudmemory.NewReflectRequest("总结用户的工程偏好"))1// 列出所有 Bank\n2banks, err := client.ListBanks(ctx)\n3\n4// 创建 Bank\n5req := cloudmemory.CreateBankRequest{}\n6req.SetName("My Agent Memory")\n7req.SetMission("Help me remember everything")\n8bank, err := client.CreateBank(ctx, "my-agent", req)\n9\n10// 获取 Bank 信息\n11bank, err := client.GetBank(ctx, "my-agent")\n12\n13// 获取 Bank 统计\n14stats, err := client.GetBankStats(ctx, "my-agent")\n15\n16// 删除 Bank\n17out, err := client.DeleteBank(ctx, "my-agent")1// 列出记忆\n2memories, err := client.ListMemories(ctx, "my-agent",\n3 cloudmemory.ListMemoriesOptions{Limit: 20})\n4\n5// 列出文档\n6docs, err := client.ListDocuments(ctx, "my-agent",\n7 cloudmemory.ListDocumentsOptions{Limit: 10})\n8\n9// 列出实体\n10entities, err := client.ListEntities(ctx, "my-agent", 10, 0)\n11\n12// 实体关系图\n13graph, err := client.EntityGraph(ctx, "my-agent", 50, 2)\n14\n15// 健康检查\n16health, err := client.Health(ctx)\n17\n18// 版本信息\n19version, err := client.Version(ctx)1f, _ := os.Open("product-guide.md")\n2defer f.Close()\n3out, err := client.FilesRetain(ctx, "<YOUR_BANK_ID>", []*os.File{f}, "")SDK 错误统一通过 *GenericOpenAPIError 抛出：
1var apiErr *cloudmemory.GenericOpenAPIError\n2if errors.As(err, &apiErr) {\n3 log.Printf("API error: %s", apiErr.Body())\n4}