开源全能意图、指令识别框架 OddAgent 更新

news/2026/1/19 18:31:28/文章来源:https://www.cnblogs.com/oddmeta/p/19503334

一、前言

上周四下午领导说公司的某个助手项目准备启用自研的备用方案，然后我的 OddAgent 项目就开始从备胎出现转机，有可能会成为正式方案了。

原先我没有为 OddAgent 设定开源授权方案，大家都可以继续在 OddAgent 现有的开源代码基础上自行演进，而公司的产品一旦正式使用了 OddAgent，那可能日后的一些功能实现就不方便放到我的github上了。

不过，以我自己在小落同学项目中一些实际功能的测试体验，现有的 OddAgent 已经足以应付各种个人/企业场景下的意图识别功能。

为了避免日后大家在授权问题上出现顾虑，我特别将 OddAgent 的授权从GPL改成了MIT。

二、关于新的开源协议MIT

MIT协议允许你任意的使用、复制、修改原MIT代码库，随便你是选择跟我一样继续开源，还是选择闭源甚至商用，唯一需要遵循的原则就是在你的软件中声明你也使用的是MIT协议就行了。

MIT 协议

核心特点：最宽松的协议之一，允许任意修改、分发，甚至闭源商用；只需在副本中保留原作者的版权和许可声明。
适用场景：个人项目、工具类库、追求高兼容性的代码（如 Vue.js、React、jQuery 均采用）。
关键约束：无开源贡献要求，不承担任何使用风险。

三、OddAgent的安装与使用

1. 安装

pip install oddagent

2. 配置

项目配置样例：https://oddmeta.net/tools/oddagent/config.json.sample
智能体配置样例：https://oddmeta.net/tools/oddagent/conference_config.json

下载好后放在你前面创建的目录下。然后复制config.json.sample，并将其改名为config.json

然后开始调整设置 config.json 里配置你自己的系统配置

下面是一个系统配置的示例。

1）大模型配置

  "GPT_URL": "https://qianfan.baidubce.com/v2/chat/completions","MODEL": "ernie-4.5-turbo-128k","API_KEY": "your api key",

2）智能体功能配置

根据你自己的业务需求，配置你的功能意图和槽位的语料。OddAgent自带了一个视频会议场景的示例 conference_config.json ，可供您的参考。

具体的配置方法可参考这里：https://pypi.org/project/oddagent/

3. 运行

启动命令：oddagent -c config.json

4. 测试后台

默认的测试后台地址是：http://localhost:5050

5. API接口

OddAgent只做意图、指令的识别，所以实际场景里基本上都是在你自己的产品里用API来调用OddAgent识别意图指令，然后自行去实现相应的功能。

以下是一个API调用OddAgent的完整示例代码：

import json
import requestsAPI_BASE_URL = 'http://127.0.0.1:5050/oddagent/chat'                # API地址def recognize_intent(message):"""调用api_oddagent_chat API"""try:response = requests.post(API_BASE_URL,json={'question': message, 'api_mode': 1 # 模拟API结果，0-不模拟，1-模拟，2-自定义API}, headers={'Content-Type': 'application/json'},timeout=30)response.raise_for_status()data = response.json()return { 'err_code': 200, 'message': 'success', 'data': data}except Exception as e:print(f"API调用失败: {str(e)}")return { 'err_code': 500, 'message': f'API调用失败: {str(e)}', 'data': None }if __name__ == '__main__':json_response = recognize_intent("开个周例会")print(json.dumps(json_response, ensure_ascii=False, indent=2))

运行测试代码：python test_oddagent.py