核心概念
以 Markdown 查看了解 HeartBeatAgents 的基本构建模块:智能体、对话、工具、记忆、频道、集成和常驻指令。
HeartBeatAgents 围绕若干核心概念构建。理解这些概念将帮助你设计出高效的智能体,并充分发挥平台的能力。
智能体
智能体是一个具有明确角色、性格和一系列能力的自主 AI 实体。每个智能体都拥有一个主要的 LLM 提供商与模型、一套管理其行为的常驻指令、对特定工具和频道的访问权限,以及属于自己的记忆存储。智能体独立运作,你可以同时运行多个智能体,各自专精于不同的职能(客服、销售、工程等)。
关键属性: 名称、描述、提供商、模型、常驻指令、自主性级别(受监督、半自主、完全自主)、状态(启用、暂停、已归档)。
对话
对话是用户与智能体之间的一系列消息。对话会在多轮交互中保持状态,可能持续数小时、数天甚至数周。每个对话都属于特定的智能体,并关联到特定的频道:它是交互的主要单位,也是情景记忆的来源。
关键属性: 对话 ID、智能体 ID、频道、参与者身份、消息历史、状态(进行中、已解决、已升级)、元数据。
工具
工具是智能体在对话中可以调用的离散能力。每个工具都有名称、描述(供 LLM 阅读以理解何时使用它)、输入参数和执行处理程序。工具由集成提供:连接一个 Stripe 集成后,stripe_get_customer 和 stripe_create_refund 等工具便可使用。
关键属性: 工具名称、描述、参数结构、集成来源、所需权限、速率限制。
规划
用自然语言表达的目标会被拆解成一系列按依赖关系排序的步骤,在开始执行任何操作之前,都会展示给你进行批准、编辑或拒绝。参见规划。
实时预览
智能体可以在其沙盒化的工作环境中运行真实的开发服务器或长时间运行的进程,并把一个真实可用的实时预览直接呈现给你,而不是对它的文字描述。参见实时预览。
委派
智能体可以把一个子任务交给另一个它被授权访问的智能体,并取回结果,就像一个人把任务委派给队友一样。参见委派。
记忆
记忆为智能体提供跨对话的连贯性,具体实现为三种类型:
- 情景记忆: 存储对话历史,使智能体能够回忆先前的互动。
- 语义记忆: 存储提取出的事实与知识:偏好、账户信息、决策。
- 程序性记忆: 存储已学会的行为模式,使智能体在遇到重复出现的任务类型时能够复用已成功的多步骤流程。
所有记忆类型都使用向量嵌入进行检索,因此智能体是通过语义相似度而非仅靠关键词匹配来找到相关记忆的。
频道
频道是智能体与用户互动的通信平台:支持 20 多个平台,包括 Slack、Discord、Microsoft Teams、Telegram、WhatsApp、短信、邮件和网页聊天。每个频道都有自己的适配器,将消息标准化为统一格式;一个智能体可以同时连接多个频道,无论对话发生在哪个频道,其上下文都会保持一致。完整列表和配置步骤请参见频道指南。
语音
语音是在浏览器中与智能体进行的实时语音对话,与上面基于文本的频道是分开的。它需要先连接一个 LiveKit 项目(用于传输)和一个语音提供商(Deepgram 或 ElevenLabs)才能使用。参见语音和语音设置。
集成
集成将智能体连接到外部服务,通常通过 OAuth 2.0 进行身份验证。连接一个集成会自动发现并向你的智能体开放其工具:Google Workspace、Microsoft 365、GitHub、Jira、HubSpot、Salesforce、Stripe、Notion 等等。完整目录和安全模型请参见集成指南。
常驻指令
常驻指令是定义智能体在所有对话中行为的持久性指令。与单一的系统提示词不同,它们是结构化的(角色定义、行为规则、知识边界、升级策略、操作限制)并且带有版本管理,因此你可以回滚产生不良行为的更改。它是决定智能体质量的单一最重要因素。
关键属性: 指令文本、版本号、创建日期、启用状态、关联的智能体、更改历史。