bee agent framework

蜜蜂代理框架

用于构建，部署和提供强大代理工作流程的开源框架。

Bee代理框架使您可以轻松地使用您的选择模型来构建基于可扩展的代理工作流程。该框架的设计目的是使用IBM花岗岩和Llama 3.X型号进行稳健性，我们正在积极地在其他流行的LLMS上优化其性能。

我们的目标是使开发人员能够采用最新的开源和专有模型，其当前代理实施的变化很小。

关键功能

• ？ AI代理：使用我们强大的蜜蜂代理，用于骆驼3.1和花岗岩3.0，或自己构建自己的蜜蜂代理。
• 工具：使用我们的内置工具或在JavaScript/Python中创建自己的工具。
• ？ ‍代码解释器：在沙盒容器中安全运行代码。
• ？内存：优化令牌支出的多种策略。
• ⏸️序列化处理复杂的代理工作流程，并轻松暂停/恢复它们而不会失去状态。
• ？仪器：使用基于发射极的仪器对代理人的内部工作有充分的可见性。
• ？带有缓存和错误处理的生产级控制。
• ？ API ：使用与OpenAI兼容的助手API和Python SDK整合您的代理商。
• CHAT UI ：用内置透明度，解释性和用户控件将您的代理商服务于令人愉悦的UI中的用户。
• ...更多关于我们的路线图

入门

提示

您是否想要一个带有蜜蜂，代码解释器和可观察性的打字稿项目？查看我们的Bee Framework开胃菜。

提示

您想在网络浏览器中与Bee合作吗？请参阅Bee Stack

安装

npm install bee-agent-framework

或者

yarn add bee-agent-framework

例子

 import { BeeAgent } from "bee-agent-framework/agents/bee/agent" ;
import { OllamaChatLLM } from "bee-agent-framework/adapters/ollama/chat" ;
import { TokenMemory } from "bee-agent-framework/memory/tokenMemory" ;
import { DuckDuckGoSearchTool } from "bee-agent-framework/tools/search/duckDuckGoSearch" ;
import { OpenMeteoTool } from "bee-agent-framework/tools/weather/openMeteo" ;

const llm = new OllamaChatLLM ( ) ; // default is llama3.1 (8B), it is recommended to use 70B model

const agent = new BeeAgent ( {
  llm , // for more explore 'bee-agent-framework/adapters'
  memory : new TokenMemory ( { llm } ) , // for more explore 'bee-agent-framework/memory'
  tools : [ new DuckDuckGoSearchTool ( ) , new OpenMeteoTool ( ) ] , // for more explore 'bee-agent-framework/tools'
} ) ;

const response = await agent
  . run ( { prompt : "What's the current weather in Las Vegas?" } )
  . observe ( ( emitter ) => {
    emitter . on ( "update" , async ( { data , update , meta } ) => {
      console . log ( `Agent ( ${ update . key } ) ? : ` , update . value ) ;
    } ) ;
  } ) ;

console . log ( `Agent ? : ` , response . result . text ) ;

➡️请参见一个更高级的示例。

➡️您可以在本地安装后运行此示例，使用命令yarn start examples/agents/simple.ts

提示

要运行此示例，请确保您已使用下载Llama3.1模型安装了Ollama。

提示

文档可在https://i-am-bee.github.io/bee-agent-framework/上获得

本地安装

笔记

yarn应通过CorePack（教程）安装

1. 克隆存储库git clone [email protected]:i-am-bee/bee-agent-framework 。
2. 安装依赖项yarn install 。
3. 创建.env （来自.env.template ），然后填写缺失值（如果有）。
4. 启动代理yarn run start:bee （它运行/examples/agents/bee.ts文件）。

➡️所有示例都可以在示例目录中找到。

➡️要运行一个任意示例，请使用以下命令yarn start examples/agents/bee.ts （只需将适当的路径传递到所需的示例）即可。

？模块

源目录（ src ）提供了许多人可以使用的模块。

姓名	描述
代理商	基本类定义代理的常见接口。
LLMS	基础类定义文本推理的通用接口（标准或聊天）。
模板	基于Mustache迅速模板系统以及各种改进。
记忆	各种类型的记忆要与代理一起使用。
工具	代理可以使用的工具。
缓存	可以与工具一起使用的不同缓存方法的预设。
错误	错误类和帮助者快速捕获错误。
适配器	给定模块为不同环境的具体实现。
记录器	用于记录框架中所有操作的核心组件。
序列化器	能够序列化模块序列化格式的核心组件。
版本	代表框架的常数（例如，最新版本）
发射极	通过发射事件为系统带来可见性。
内部	框架中其他模块使用的模块。

要查看更多深入的解释，请参阅概述。

教程

？即将推出 ？

路线图

• 蜜蜂代理性能优化与其他模型
• 示例，教程和文档
• 改进定制代理商
• 多代理编排

贡献指南

Bee Agent Framework是一个开源项目，我们是我们的贡献。

如果您想为蜜蜂做出贡献，请查看我们的贡献指南。

错误

我们正在使用GitHub问题来管理我们的公共错误。我们密切关注此问题，因此在提交新问题之前，请检查以确保尚未记录它。

行为守则

该项目和参与该项目的每个项目都受到行为准则的约束。通过参加，您应该维护此代码。请阅读全文，以便您可以阅读哪些动作可能会被容忍。

法律通知

这些存储库（包括代码）中的所有内容均由IBM根据相关的开源软件许可提供，而IBM无义务提供增强功能，更新或支持。 IBM开发人员将此代码作为开源项目（不是作为IBM产品）生成，而IBM对质量或安全性水平也没有任何断言，并且不会维护此代码未来。

贡献者

特别感谢我们的贡献者帮助我们改善Bee Agent框架。