[Go] Acontext Memory项目实战：专为AI代理设计的上下文数据平台

项目简介

Acontext是一个专为AI代理设计的上下文数据平台，具备以下核心功能：

• 存储上下文数据和代理工作产物
• 观测代理任务执行状态和用户反馈
• 通过将操作经验转化为标准化流程，实现代理的自我学习能力
• 提供本地化仪表板，用于查看消息、任务、工作产物和经验积累

Acontext三大核心功能：存储、观察和学习

该平台的设计目标是帮助开发者：

• 构建更具可扩展性的代理产品架构
• 显著提高代理任务成功率，减少不必要的运行步骤

通过Acontext，您的AI代理能够获得更稳定的表现，为用户提供更高的价值。

核心概念

• Session - 支持多模态消息存储的对话线程
• Task Agent - 后台任务代理，负责收集任务状态、进度和用户偏好
• Disk - 代理工作产物的文件存储系统
• Space - 类Notion的知识空间，用于存储学习到的技能
• Experience Agent - 后台经验代理，负责提炼、保存和检索技能

系统架构与协作流程

┌──────┐    ┌────────────┐    ┌──────────────┐    ┌───────────────┐
│ User │◄──►│ Your Agent │◄──►│   Session    │    │ Artifact Disk │
└──────┘    └─────▲──────┘    └──────┬───────┘    └───────────────┘
                  │                  │
                  │         ┌────────▼────────┐
                  │         │ Observed Tasks  │
                  │         └────────┬────────┘
                  │                  │
                  │         ┌────────▼────────┐
                  │         │  Space (learn)  │
                  │         └────────┬────────┘
                  │                  │
                  └──────────────────┘
                  技能指导代理

代理技能的具体表现形式：

{
    "use_when": "star a repo on github.com",
    "preferences": "use personal account. star but not fork",
    "tool_sops": [
        {"tool_name": "goto", "action": "goto github.com"},
        {"tool_name": "click", "action": "find login button if any. login first"},
        ...
    ]
}

代理经验以结构化形式存储在Space中，包含文件夹、页面和代码块层级：

/
└── github/ (folder)
    └── GTM (page)
        ├── find_trending_repos (sop block)
        └── find_contributor_emails (sop block)
    └── basic_ops (page)
        ├── create_repo (sop block)
        └── delete_repo (sop block)
    ...

快速开始

Acontext提供了acontext-cli工具，帮助开发者快速进行概念验证。首先在终端中下载命令行工具：

curl -fsSL https://install.acontext.io | sh

确保已安装Docker并准备好OpenAI API密钥，然后在本地启动Acontext后端服务：

acontext docker up

本地部署Acontext至少需要配置OpenAI API密钥。推荐使用gpt-5.1或gpt-4.1作为LLM模型。

服务启动后，可以访问以下端点：

• Acontext API Base URL: http://localhost:8029/api/v1
• Acontext Dashboard: http://localhost:3000/

成功率指标监控仪表板

使用指南

使用acontext命令行工具下载端到端示例脚本：

OpenAI SDK + Acontext (Python)

acontext create my-proj --template-path "python/openai-basic"

OpenAI SDK + Acontext (TypeScript)

acontext create my-proj --template-path "typescript/openai-basic"

OpenAI Agent SDK + Acontext (Python)

acontext create my-proj --template-path "python/openai-agent-basic"

Agno + Acontext (Python)

acontext create my-proj --template-path "python/agno-basic"

vercel/ai-sdk + Acontext (TypeScript)

acontext create my-proj --template-path "typescript/vercel-ai-basic"

更多模板示例请参考官方示例仓库：Acontext-Examples。

项目地址

https://github.com/memodb-io/Acontext/blob/main/readme/zh/README.md