多接口AI代理框架

Heurist Agent Framework是一个灵活的多接口AI代理框架,支持通过Telegram、Discord、Twitter、Farcaster、REST API和MCP等多种平台进行交互,具备文本和语音处理、图像和视频生成、知识库存储以及外部API集成等功能。

  • by heurist-network
  • Python
  • 本地部署
  • 826 星标
  • 更新于
在 GitHub 查看 heurist-network/heurist-agent-framework

使用说明

启发式代理框架

一个灵活的多界面人工智能代理框架,可以通过各种平台进行交互,包括Telegram、Discord、Twitter、Farcaster、REST API和MCP。

在上提交表单时,使用代码“代理”立即免费获取Heurist API密钥https://heurist.ai/dev-access


概述

启发式代理框架基于模块化架构构建,允许AI代理:

  • 处理文本和语音消息
  • 生成图像和视频
  • 以一致的行为在多个平台上进行交互
  • 在知识库中获取和存储信息(支持Postgres和SQLite)
  • 访问外部API、工具和各种 网眼剂 组合复杂的工作流

目录

特性

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

启发式网格

启发式网格 是人工智能代理的技能市场,是您通往Web3智能的门户。通用人工智能模型缺乏关于Web3的专业知识,往往无法提供准确的结果。Heurist Mesh通过提供30多个专门的人工智能代理来解决这个问题,这些代理是加密分析的专家,随时可以为您的应用程序或人工智能代理提供他们所需的Web3专业知识。

为什么选择启发式网格?

  • 精心策划的Web3工具:我们策划最好的Web3数据源和API,不断监控和更新以获得可靠的性能。
  • 针对代理进行了优化:针对AI代理优化的输入/输出格式-与简单的API包装器相比,工具调用减少70%,令牌使用减少30-50%。
  • 可组合架构:混合搭配专业代理,构建强大的工作流程。
  • 灵活的访问:具有API密钥的REST API, x402已启用 在Base上使用USDC按次付费,以及MCP访问。
  • 可信代理标准:每个代理MCP都在 ERC-8004 以太坊上的可信代理标准。

代理类别

类别 描述 代理示例
聚合加密货币见解 全面的代币和市场情报(推荐) 代币解析器、趋势代币、推特情报
令牌信息 价格数据、市场指标、代币分析 CoinGecko、DexScreener、Bitquery、aixbt
社交媒体 推特/X分析、影响者跟踪、情绪 Elfa、Moni、推特信息
区块链数据 链上分析、地址智能、取证 Etherscan、ChainBase、空间和时间
网络搜索 基于人工智能总结的网络研究 Exa、Firecrawl、Caesar
加密货币产品 用于DeFi和NFT的平台特定工具 Pump.fun、LetsBonk、Zora、Aave
钱包分析 投资组合跟踪和钱包行为分析 Pond AI、GoPlus、Zerion

开始使用Mesh

MCP支持

所有启发式网格代理都可以通过MCP访问。这意味着您可以从任何支持MCP的AI客户端和框架访问它们,包括Claude、ChatGPT、Cursor、LangChain、Google ADK、n8n等。

访问 启发式网格控制台 查看所有MCP端点,并通过混合和匹配所需的代理来创建专用MCP服务器。MCP服务器源代码可在 Github:heurist网格mcp服务器.

使用和开发指南

阅读Mesh文档

启发式代理框架架构

🔍 点击徽章探索技术见解,提问。

该框架遵循模块化、基于组件的架构:

代理结构

  1. BaseAgent (抽象基类)

    • 定义接口和通用功能
    • 管理组件初始化和生命周期
    • 实现核心消息传递模式
  2. CoreAgent (具体实施)

    • 实现BaseAgent功能
    • 协调组件和工作流
    • 处理工作流选择的决策

代理接口

每个接口都继承自BaseAgent,并实现了特定于平台的处理:

  • 电报 (interfaces/telegram_agent.py)
  • Discord 的中文翻译是“不和谐”或“纷争”。 (interfaces/discord_agent.py)
  • API (interfaces/flask_agent.py)
  • 推特 (interfaces/twitter_agent.py)
  • 法尔卡斯特 (interfaces/farcaster_agent.py)

启发式核心

Heurist Core提供了一组核心组件、工具和工作流,用于构建LLM驱动的代理或代理应用程序。它可以作为一个独立的包使用,也可以作为启发式代理框架的一部分使用。

阅读启发式核心文档

组件

该框架使用模块化组件系统:

  • 个性化提供商:管理代理个性和系统提示
  • 知识提供者:处理从矢量数据库检索知识
  • 会话管理器:管理对话历史和上下文
  • 验证管理器:验证输入和输出
  • 媒体处理程序:处理图像、音频和其他媒体
  • LLM提供者:与语言模型的接口
  • 消息存储:使用矢量搜索存储和检索邮件

工作流

工作流提供了更高级的推理模式:

  • 增强型LMCall:用于上下文感知响应的标准RAG+工具模式
  • 思维推理链:具有规划和执行阶段的多步推理
  • 研究工作流程:具有层次探索的深层网络搜索和分析

工具管理

  • 工具箱:工具定义和注册的基本框架
  • 工具:工具管理和执行层
  • 工具MCP:与MCP协议集成以执行工具

外部客户端

  • 搜索客户端:用于网络搜索的统一客户端(Firecrawl/Exa)
  • MCP客户端:本地或远程服务器的MCP协议客户端。

代理使用和开发指南

阅读 代理使用和开发指南

开发设置

要设置开发环境,请执行以下操作:

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

[!注意] 要运行文件,您可以使用 python <filename>.py 或 uv run <filename>.py.

如何使用GitHub问题

我们鼓励社区开放 GitHub问题 每当你有新想法或发现需要关注的事情时。创建问题时,请使用我们的 问题模板 并选择以下类别之一:

  1. 集成请求

    • 用于与新数据源(例如CoinGecko、arXiv)或新AI用例集成的请求。
    • 最重要 对于社区来说,这些问题有助于推动我们框架的发展方向。
    • 如果你有一个想法,但不确定如何实施,可以在这个标签下打开一个问题,这样其他人就可以接受它或提供建议。
  2. 程序错误

    • 用于报告框架中的错误或意外行为。
    • 提供尽可能多的细节(日志、复制步骤、环境等)。
  3. 问题

    • 有关用法、最佳实践或现有功能说明的询问。
  4. 赏金

    • 对于具有a的任务 奖励 (例如,代币、NFT或其他福利)。
    • 赏金标签表示Heurist团队或其他社区成员正在向解决问题的人提供奖励。
    • 赏金规则:
      • 确保仔细阅读问题描述,了解范围和验收标准。
      • 一旦您处理赏金的拉取请求被合并,我们将跟进完成奖励。
      • 问题本身可能包含其他说明(例如联系方式)。

提出一个问题

  • 寻找 集成请求 或 赏金 如果你想贡献新功能或获得奖励,就会遇到问题。
  • 欢迎在评论中讨论方法。如果你准备好解决这个问题,请提到“我正在努力!”这样其他人就知道它正在进行中。

这一过程有助于我们保持组织性,鼓励社区参与,并保持发展的透明度。

许可证

BSL 1.1-有关详细信息,请参阅许可证文件。

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 提交您的更改
  4. 推到分支
  5. 创建拉取请求

有关Heurist Mesh代理或了解如何贡献专业社区代理,请参阅 Mesh自述

支持

如需支持,请在GitHub存储库中打开问题或联系维护人员。加入Heurist生态系统生成器电报https://t.me/heuristsupport

明星历史