RAGFlow金十数据工具：财经新闻与市场数据的实时获取

在金融投资领域，及时准确的市场信息是决策的关键。RAGFlow的金十数据工具（agent/tools/jin10.py）为用户提供了实时财经新闻、市场行情和经济日历数据的一站式获取方案，帮助投资者快速捕捉市场动态，做出明智决策。

工具功能概述

金十数据工具支持四种核心数据类型的获取，满足不同场景下的信息需求：

• 快讯（flash）：实时推送全球金融市场的突发新闻和重要事件
• 经济日历（calendar）：提供全球主要经济体的经济指标发布时间表
• 市场行情（symbols）：获取各类金融产品的实时报价和历史数据
• 新闻资讯（news）：聚合全球财经媒体的最新报道

参数配置详解

金十数据工具的参数配置在agent/tools/jin10.py的Jin10Param类中定义，主要参数包括：

参数验证逻辑确保了输入的合法性，相关代码如下：

def check(self):
    self.check_valid_value(self.type, "Type", ['flash', 'calendar', 'symbols', 'news'])
    self.check_valid_value(self.flash_type, "Flash Type", ['1', '2', '3', '4', '5'])
    # 其他参数验证...

数据获取流程

金十数据工具的数据获取流程在Jin10类的_run方法中实现，主要步骤包括：

1. 输入参数验证与处理
2. 根据数据类型构造API请求
3. 发送HTTP请求获取数据
4. 数据格式化与转换
5. 返回处理结果

核心代码实现如下：

def _run(self, history, **kwargs):
    # 输入处理
    ans = self.get_input()
    ans = " - ".join(ans["content"]) if "content" in ans else ""
    
    # 数据获取
    headers = {'secret-key': self._param.secret_key}
    try:
        if self._param.type == "flash":
            # 快讯数据获取逻辑
            params = {'category': self._param.flash_type}
            response = requests.get(url='https://open-data-api.jin10.com/data-api/flash', 
                                   headers=headers, data=json.dumps(params))
            # 其他数据类型处理...
    except Exception as e:
        return Jin10.be_output("**ERROR**: " + str(e))
    
    # 结果返回
    return pd.DataFrame(jin10_res)

使用场景示例

1. 获取商品市场实时行情

配置参数：

param = Jin10Param()
param.type = "symbols"
param.symbols_type = "GOODS"
param.symbols_datatype = "quotes"

此配置将返回全球主要商品的实时报价，包括黄金、原油、铜等大宗商品的最新价格、涨跌幅等信息。

2. 监控重要经济指标发布

配置参数：

param = Jin10Param()
param.type = "calendar"
param.calendar_type = "us"
param.calendar_datatype = "data"

通过此配置，用户可以获取美国重要经济指标（如非农就业数据、GDP增长率等）的发布时间表和预期值。

与RAGFlow其他模块集成

金十数据工具可以与RAGFlow的其他功能模块无缝集成，构建更强大的金融分析应用：

• 与agent/tools/retrieval.py结合，实现历史数据的检索与分析
• 与rag/prompts/中的提示模板配合，生成智能化的市场分析报告
• 与agent/templates/financial_analysis.json中的工作流模板结合，实现自动化投资决策支持

使用注意事项

1. 金十数据API需要有效的secret-key，用户需自行申请并配置
2. 不同类型的数据返回格式有所差异，需根据实际需求进行解析
3. 频繁请求可能受到API调用频率限制，建议合理设置请求间隔
4. 市场数据具有时效性，应结合实际情况判断数据有效性

通过金十数据工具，RAGFlow为金融从业者和投资者提供了高效、便捷的市场信息获取渠道。结合RAGFlow的文档理解和智能分析能力，用户可以快速从海量金融数据中提取有价值的 insights，为投资决策提供有力支持。