OpenBB Agents: 融合LLM与金融数据的智能分析工具

openbb-agents

OpenBB Agents简介

OpenBB Agents是一个正在开发中的开源项目,它巧妙地结合了大型语言模型(LLM)和OpenBB金融数据平台的强大功能。该项目的目标是创建能够自主进行金融研究并利用最新数据回答问题的智能金融分析代理。这一创新性的融合使得金融分析变得更加智能和高效。

OpenBB Agents的核心优势在于其利用函数调用与OpenBB平台进行交互的能力。这种方法使得代理能够实时获取和分析最新的金融数据,从而提供准确、及时的分析结果。

OpenBB Agents Architecture

安装与设置

安装要求

目前,OpenBB Agents支持Python 3.10及以上版本。开发团队正在努力扩展对更多Python版本的支持,以满足更广泛的用户需求。

安装步骤

OpenBB Agents可以通过PyPI包管理器轻松安装。只需在命令行中运行以下命令:

pip install openbb-agents --upgrade

配置API密钥

要充分利用OpenBB Agents的功能,用户需要配置两个关键的API:

OpenAI API密钥:
- 在OpenAI官网注册并获取API密钥
- 将API密钥添加到环境变量中:
```
export OPENAI_API_KEY="your_openai_api_key"
```
OpenBB平台数据提供商凭证: 用户有两种方式配置数据提供商凭证:

a. 本地配置: - 在~/.openbb_platform/user_settings.json文件中指定凭证 - 按照本地环境设置指南进行详细配置

b. OpenBB Hub: - 通过OpenBB Hub账户创建个人访问令牌(PAT) - 将PAT作为参数传递给代理

使用指南

基本用法

OpenBB Agents的使用非常直观。以下是一个简单的示例:

from openbb_agents.agent import openbb_agent

result = openbb_agent("What is the current market cap of TSLA?")
print(result)

输出示例:

- The current market cap of TSLA (Tesla, Inc.) is approximately $695,833,798,800.00.
- This figure is based on the most recent data available, which is from January 15, 2024.
- The market cap is calculated by multiplying the current stock price ($218.89) by the number of outstanding shares (3,178,920,000).

高级查询

OpenBB Agents能够处理复杂的查询,例如:

openbb_agent("Perform a fundamentals financial analysis of AMZN using the most recently available data. What do you find that's interesting?")

这类查询展示了代理处理复杂金融分析任务的能力。

时序依赖查询

代理还可以处理具有时序依赖性的查询:

openbb_agent("Who are TSLA's peers? What is their respective market cap? Return the results in descending order of market cap.")

这种查询展示了代理处理多步骤、相互依赖问题的能力。

异步支持

对于需要异步处理的场景,OpenBB Agents提供了异步变体:

from openbb_agents.agent import aopenbb_agent

await aopenbb_agent("What is the current market cap of TSLA?")

技术深度探讨

架构设计

OpenBB Agents的架构设计巧妙地结合了LLM的自然语言处理能力和OpenBB平台的金融数据访问能力。核心组件包括:

LLM引擎: 负责理解用户查询,生成响应,并决定何时调用特定工具。
函数调用接口: 允许LLM与OpenBB平台进行交互,获取所需的金融数据。
数据处理模块: 处理从OpenBB平台获取的原始数据,转换为LLM可理解的格式。
响应生成器: 基于LLM的输出和处理后的数据,生成最终的用户友好响应。

关键技术

动态工具配置: 代理能够根据可用的数据提供商凭证动态配置自身。这意味着某些数据源和功能可能需要适当的API密钥才能访问。
yfinance集成: 默认情况下,yfinance作为数据提供商包含在内,无需额外的API密钥。这为用户提供了基本的数据访问能力。
异步处理: 通过提供异步变体,OpenBB Agents能够更好地处理长时间运行的查询,提高整体性能。
上下文管理: 代理能够维护对话上下文,处理具有时序依赖性的多步查询。

开发者指南

对于有兴趣参与OpenBB Agents开发的开发者,项目提供了详细的开发指南:

环境设置:
- 使用poetry创建新的虚拟环境
- 运行poetry install安装依赖
代码风格和格式化:
- 使用ruff作为black, isort和pylint的替代品
- 运行ruff check进行代码检查
- 使用ruff check --fix修复linting错误
- 使用ruff format格式化代码
自动化检查:
- 项目集成了pre-commithooks,可通过pre-commit install安装
测试:
- 使用pytest作为测试运行器
- 运行pytest -n 8 tests/执行测试