Heurist Agent Framework

启发式代理框架

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

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

______________________________________________________________________

概述

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

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

目录

• 特性
• 启发式网格

- 为什么选择启发式网格？ - 代理类别 - 开始使用Mesh - MCP支持 - 使用和开发指南

• 启发式代理框架架构

- 代理结构 - 代理接口 - 启发式核心 - 组件 - 工作流 - 工具管理 - 外部客户端 - 代理使用和开发指南

• 开发设置
• 许可证
• 贡献
• 支持
• 明星历史

特性

• 🤖 核心代理 -具有高级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 以太坊上的可信代理标准。

代理类别

开始使用Mesh

• 网状网入口: mesh.heurist.ai -浏览代理并部署专用MCP服务器
• REST API: API 文档
• X402 API: mesh.heurist.xyz/x402/代理 -使用USDC按次支付
• 完整代理列表: 查看所有代理

MCP支持

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

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

使用和开发指南

阅读Mesh文档

启发式代理框架架构

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

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

代理结构

1. BaseAgent （抽象基类）

- 定义接口和通用功能 - 管理组件初始化和生命周期 - 实现核心消息传递模式

1. 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 .py 或 uv run .py.

如何使用GitHub问题

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

1. 集成请求

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

1. 程序错误

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

1. 问题

- 有关用法、最佳实践或现有功能说明的询问。

1. 赏金

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

提出一个问题

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

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

许可证

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

贡献

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

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

支持

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

明星历史