STARWARCLOUD STARWAR.AI
返回市场
启发式代理框架

启发式代理框架

作者：heurist-network704 星标更新：2025-11-20
安装使用来源：spider==github.com

项目介绍

<div align="center"> <img src="./docs/img/agent-framework-poster.jpg" alt="Heurist Agent Framework 宣传图" width="100%" /> </div>

Heurist Agent Framework

一个灵活的多接口AI代理框架，可以通过包括Telegram、Discord、Twitter、Farcaster、REST API和MCP在内的多个平台进行交互。

通过在https://heurist.ai/dev-access提交表单时使用代码'agent'，可以立即免费获取Heurist API密钥。

概述

Heurist Agent Framework基于模块化架构构建，允许AI代理执行以下操作：

  • 处理文本和语音消息
  • 生成图像和视频
  • 在多个平台上以一致的行为进行交互
  • 获取并存储信息到知识库中（支持Postgres和SQLite）
  • 访问外部API、工具以及广泛的Mesh Agents，以组合复杂的流程

目录

特性

  • 🤖 核心代理 - 具有高级LLM集成的模块化框架
  • 🧩 组件架构 - 插拔式组件，用于灵活设计代理或代理应用程序
  • 🔄 工作流系统 - RAG、思维链和研究工作流
  • 🖼️ 媒体生成 - 图像创建和处理能力
  • 🎤 语音处理 - 音频转录和文本转语音
  • 💾 向量存储 - 支持PostgreSQL/SQLite的知识检索
  • 🛠️ 工具集成 - 扩展工具框架，支持MCP
  • 🌐 Mesh Agent访问 - 通过API或MCP连接到社区贡献的专业代理
  • 🔌 多平台支持：
    • Telegram机器人
    • Discord机器人
    • Twitter自动化
    • Farcaster集成
    • REST API
    • MCP集成

Heurist Mesh

mesh

Heurist Mesh是Web3 AI的技能市场。它是一个开放的、由专业且可组合的AI代理组成的网络。每个代理都是一个单元，能够检查代币性能、理解社交情绪、生成报告或执行动作，同时作为一个智能群落来解决复杂任务。每个代理和工具都可以通过REST API和MCP访问，并可以与任何代理框架或应用结合使用。

想要在你的应用中集成Heurist Mesh？查看MESH README以获取详细的指南、示例和最佳实践。

MCP支持

所有Heurist Mesh代理都可通过MCP访问。这意味着你可以从任何支持MCP的AI客户端和框架中访问它们，包括Claude、ChatGPT、Cursor、LangChain、Google ADK、n8n等。

访问MCP门户自定义你的MCP服务器，通过混合匹配你需要的代理。MCP服务器源代码可以在Github: heurist-mesh-mcp-server找到。

完整的Mesh Agents列表

查看完整列表

使用和开发指南

阅读Mesh文档

Heurist Agent Framework 架构

询问DeepWiki 🔍 点击徽章探索技术见解，提问。

该框架遵循模块化、组件化的架构：

<div align="center"> <img src="./docs/img/agent_hl.png" alt="Heurist Agent Framework" width="75%"> </div>

代理结构

  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 Agent Framework的一部分。

阅读Heurist Core文档

组件

框架使用模块化组件系统：

  • PersonalityProvider：管理代理个性和系统提示
  • KnowledgeProvider：处理从向量数据库检索知识
  • ConversationManager：管理对话历史和上下文
  • ValidationManager：验证输入和输出
  • MediaHandler：处理图像、音频和其他媒体
  • LLMProvider：与语言模型接口
  • MessageStore：存储和检索带有向量搜索的消息

工作流

工作流提供了更高层次的推理模式：

  • AugmentedLLMCall：标准RAG+工具模式，用于上下文感知响应
  • ChainOfThoughtReasoning：具有规划和执行阶段的多步骤推理
  • ResearchWorkflow：深度网络搜索和分析，具有分层探索

工具管理

  • ToolBox：工具定义和注册的基础框架
  • Tools：工具管理和执行层
  • ToolsMCP：与MCP协议集成，用于工具执行

外部客户端

  • SearchClient：统一的网络搜索客户端（Firecrawl/Exa）
  • MCPClient：本地或远程服务器的MCP协议客户端

代理使用和开发指南

阅读代理使用和开发指南

开发环境设置

要设置开发环境：

  1. 使用uv安装依赖项：
   uv sync
  1. 激活虚拟环境：
   source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate

[!NOTE] 要运行文件，可以使用python <filename>.py或uv run <filename>.py。

如何使用GitHub问题

我们鼓励社区在有任何新想法或发现需要关注的问题时打开GitHub问题。创建问题时，请使用我们的问题模板，并选择以下类别之一：

  1. 集成请求

    • 对于请求与新的数据源（如CoinGecko、arXiv）或新的AI用例集成。
    • 对社区来说最重要，因为这些问题有助于推动我们框架的发展方向。
    • 如果你有一个想法但不确定如何实现，可以在该标签下打开一个问题，这样其他人可以接手或提出建议。

  2. 错误

    • 报告框架中的错误或意外行为。
    • 提供尽可能多的细节（日志、重现步骤、环境等）。

  3. 问题

    • 关于使用、最佳实践或现有功能澄清的询问。

  4. 悬赏

    • 对于带有奖励的任务（例如，代币、NFT或其他福利）。
    • 悬赏标签表示Heurist团队或其他社区成员正在为解决问题的人提供奖励。
    • 悬赏规则：
      • 仔细阅读问题描述，了解范围和验收标准。
      • 一旦解决了悬赏问题的Pull Request被合并，我们将跟进奖励的履行。
      • 问题本身可能包含额外的指示（例如，联系方式）。

接手一个问题

  • 查找集成请求或悬赏问题，如果你想贡献新功能或赚取奖励。
  • 自由地在评论中讨论方法。如果你准备着手处理，请提到“我正在处理这个！”以便其他人知道正在进行中。

这一过程帮助我们保持组织有序，鼓励社区参与，并使开发透明。

许可证

MIT许可证 - 详情见LICENSE文件。

贡献

  1. 分叉仓库
  2. 创建功能分支
  3. 提交更改
  4. 推送到分支
  5. 创建Pull Request

对于Heurist Mesh代理或学习如何贡献专门的社区代理，请参阅MESH README

支持

对于支持，请在GitHub仓库中打开一个问题或联系维护者。加入Heurist生态系统建设者的电报群 https://t.me/heuristsupport

星历史

星历史图表