heurist-network/heurist-agent-framework

# Heurist 智能体框架 一个灵活的多接口AI智能体框架，可通过Telegram、Discord、Twitter、Farcaster、REST API和MCP等多种平台进行交互。 通过提交 https://heurist.ai/dev-access 表单时使用代码 'agent'，即可免费即时获取一个 Heurist API Key。 ## 概述 Heurist 智能体框架基于模块化架构构建，允许AI智能体： - 处理文本和语音消息 - 生成图像和视频 - 在多个平台间以一致的行为进行交互 - 在知识库中获取和存储信息（支持PostgreSQL和SQLite） - 访问外部API、工具以及各种 [Mesh 智能体](./mesh/README.md) 来构建复杂的工作流 ## 目录 - [功能](#features) - [Heurist Mesh](#heurist-mesh) - [为何选择 Heurist Mesh？](#why-heurist-mesh) - [智能体类别](#agent-categories) - [开始使用 Mesh](#get-started-with-mesh) - [MCP 支持](#mcp-support) - [使用与开发指南](#usage-and-development-guide) - [Heurist 智能体框架架构](#heurist-agent-framework-architecture) - [智能体结构](#agent-structure) - [智能体接口](#agent-interfaces) - [Heurist Core](#heurist-core) - [组件](#components) - [工作流](#workflows) - [工具管理](#tool-management) - [外部客户端](#external-clients) - [智能体使用与开发指南](#agent-usage-and-development-guide) - [开发环境设置](#development-setup) - [如何使用 GitHub Issues](#how-to-use-github-issues) - [许可证](#license) - [贡献](#contributing) - [支持](#support) - [星标历史](#star-history) ## 功能 - 🤖 **核心智能体** - 集成了先进LLM的模块化框架 - 🧩 **组件架构** - 即插即用的组件，用于灵活设计智能体或智能体化应用 - 🔄 **工作流系统** - RAG、思维链和研究工作流 - 🖼️ **媒体生成** - 图像创建与处理能力 - 🎠 **语音处理** - 音频转录与文本转语音 - 💾 **向量存储** - 支持PostgreSQL/SQLite的知识检索 - 🛠️ **工具集成** - 可扩展的工具框架，支持MCP - 🌐 **Mesh 智能体访问** - 通过API或MCP连接社区贡献的专用智能体 - 🔌 **多平台支持**： - Telegram 机器人 - Discord 机器人 - Twitter 自动化 - Farcaster 集成 - REST API - MCP 集成 ## Heurist 网格  **[Heurist Mesh](https://mesh.heurist.ai)** 是AI智能体的技能市场 - 您通往Web3智能的门户。通用AI模型缺乏关于Web3的专业知识，常常无法提供准确结果。Heurist Mesh 通过提供30多个精通加密分析的专用AI智能体来解决此问题，随时为您的应用或AI智能体提供所需的Web3专业知识。 ### 为何选择 Heurist Mesh？ - **精选的Web3工具**：我们精选最佳的Web3数据源和API，并持续监控和更新以确保可靠性能。 - **为智能体优化**：为AI智能体优化的输入/输出格式 - 相比简单API封装，工具调用减少70%，令牌使用量减少30-50%。 - **可组合架构**：混合搭配专用智能体以构建强大的工作流。 - **灵活访问**：使用API密钥的REST API、支持在Base链上使用USDC按需付费的 [x402-enabled](https://docs.cdp.coinbase.com/x402) API，以及MCP访问。 - **可信的智能体标准**：每个智能体的MCP都注册在以太坊上的 [ERC-8004](https://eips.ethereum.org/EIPS/eip-8004) 可信智能体标准上。 ### 智能体类别 | 类别 | 描述 | 示例智能体 | |----------|-------------|----------------| | **聚合加密洞察** | 全面的代币和市场情报（推荐） | Token Resolver, Trending Tokens, Twitter Intelligence | | **代币信息** | 价格数据、市场指标、代币分析 | CoinGecko, DexScreener, Bitquery, aixbt | | **社交媒体** | Twitter/X分析、影响者追踪、情绪分析 | Elfa, Moni, Twitter Info | | **区块链数据** | 链上分析、地址情报、取证 | Etherscan, ChainBase, Space and Time | | **网络搜索** | 带AI摘要的网络研究 | Exa, Firecrawl, Caesar | | **加密产品** | 针对DeFi和NFT的平台特定工具 | Pump.fun, LetsBonk, Zora, Aave | | **钱包分析** | 投资组合跟踪和钱包行为分析 | Pond AI, GoPlus, Zerion | ### 开始使用 Mesh - **Mesh 门户**：[mesh.heurist.ai](https://mesh.heurist.ai) - 浏览智能体并部署专用MCP服务器 - **REST API**：[API 文档](https://docs.heurist.ai/dev-guide/heurist-mesh/) - **X402 API**：[mesh.heurist.xyz/x402/agents](https://mesh.heurist.xyz/x402/agents) - 在Base链上使用USDC按需付费 - **全部智能体列表**：[查看所有智能体](./mesh/README.md#appendix-all-available-mesh-agents) ### 使用与开发指南 [阅读 Mesh 文档](./mesh/README.md) ## Heurist 智能体框架架构 [](https://deepwiki.com/heurist-network/heurist-agent-framework) 🔍 点击徽章探索技术见解，提出问题。 该框架遵循模块化、基于组件的架构： ### 智能体结构 1. **BaseAgent** (抽象基类) - 定义接口和通用功能 - 管理组件初始化和生命周期 - 实现核心消息模式 2. **CoreAgent** (具体实现) - 实现BaseAgent功能 - 编排组件和工作流 - 处理工作流选择的决策 ### 智能体接口 每个接口继承自BaseAgent并实现特定平台的处理： - **Telegram** (`interfaces/telegram_agent.py`) - **Discord** (`interfaces/discord_agent.py`) - **API** (`interfaces/flask_agent.py`) - **Twitter** (`interfaces/twitter_agent.py`) - **Farcaster** (`interfaces/farcaster_agent.py`) ### Heurist 核心 Heurist Core 提供了一套核心组件、工具和工作流，用于构建由LLM驱动的智能体或智能体化应用。它可以作为独立包使用，也可以作为Heurist智能体框架的一部分。 [阅读 Heurist Core 文档](./core/README.md) #### 组件 该框架使用模块化组件系统： - **PersonalityProvider**：管理智能体个性和系统提示词 - **KnowledgeProvider**：处理从向量数据库检索知识 - **ConversationManager**：管理对话历史和上下文 - **ValidationManager**：验证输入和输出 - **MediaHandler**：处理图像、音频和其他媒体 - **LLMProvider**：与语言模型接口 - **MessageStore**：通过向量搜索存储和检索消息 #### 工作流 工作流提供更高级别的推理模式： - **AugmentedLLMCall**：标准RAG + 工具模式，用于上下文感知的响应 - **ChainOfThoughtReasoning**：具有规划和执行阶段的多步推理 - **ResearchWorkflow**：具有分层探索的深度网络搜索和分析 #### 工具管理 - **ToolBox**：工具定义和注册的基础框架 - **Tools**：工具管理和执行层 - **ToolsMCP**：与MCP协议集成以执行工具 #### 外部客户端 - **SearchClient**：用于网络搜索（Firecrawl/Exa）的统一客户端 - **MCPClient**：用于本地或远程服务器的MCP协议客户端。 ### 智能体使用与开发指南 阅读[智能体使用与开发指南](./agents/README.md) ## 开发环境设置 要设置您的开发环境： 1. **使用 uv 安装依赖项：** ``` uv sync ``` 2. **激活虚拟环境：** ``` source .venv/bin/activate # On Windows: .venv\Scripts\activate ``` ## 如何使用 GitHub Issues 1. **集成请求** - 用于请求集成新数据源（例如 CoinGecko, arXiv）或新的AI用例。 - 对社区**最重要**，因为这些问题有助于引导我们框架演进的方向。 - 如果您有想法但不确定如何实现，请在此标签下创建一个issue，以便其他人可以接手或提供建议。 2. **Bug** - 用于报告框架中的错误或意外行为。 - 请提供尽可能多的详细信息（日志、重现步骤、环境等）。 3. **问题** - 用于咨询关于使用、最佳实践或对现有功能的澄清。 4. **赏金** - 用于带有**奖励**的任务（例如代币、NFT或其他福利）。 - 赏金标签表示Heurist团队或其他社区成员正在提供奖励给解决该issue的人。 - **赏金规则**： - 请务必仔细阅读issue描述以了解范围和验收标准。 - 一旦您的针对赏金的Pull Request被合并，我们将跟进履行奖励。 - 可能会在issue本身中包含附加说明（例如联系方式）。 ### 认领一个 Issue - 如果您想贡献新功能或赚取奖励，请寻找**集成请求**或**赏金** issues。 - 请在评论中自由讨论方法。如果您准备好解决它，请提及"I'm working on this!"，以便其他人知道它正在进行中。 ## 许可证 BSL 1.1 - 详情请参阅 LICENSE 文件。

标签：AI代理框架, Discord集成, Farcaster集成, LLM集成, MCP协议, Postgres, REST API, SQLite, Telegram集成, Twitter集成, 人工智能, 代理即服务, 代理开发, 代理服务, 代理构建工具, 区块链交互, 图像生成, 外部API访问, 多接口支持, 大型语言模型, 工作流系统, 工作流自动化, 工具使用, 推理能力, 插件架构, 数据库集成, 文本处理, 智能代理, 模块化架构, 测试用例, 深度研究, 用户模式Hook绕过, 知识库管理, 组件化设计, 视频生成, 记忆功能, 语音处理, 跨平台代理, 逆向工具