higress/plugins/wasm-go/extensions/ai-intent/README.md

title, keywords, description

title	keywords	description
AI 意图识别	AI网关 AI意图识别	AI 意图识别插件配置参考

功能说明

LLM 意图识别插件，能够智能判断用户请求与某个领域或agent的功能契合度，从而提升不同模型的应用效果和用户体验

运行属性

插件执行阶段：默认阶段 插件执行优先级：700

配置说明

1.该插件的优先级高于ai-proxy等后续使用意图的插件，后续插件可以通过proxywasm.GetProperty([]string{"intent_category"})方法获取到意图主题，按照意图主题去做不同缓存库或者大模型的选择

2.需新建一条higress的大模型路由，供该插件访问大模型,如：路由以 /intent 作为前缀，服务选择大模型服务，为该路由开启ai-proxy插件

3.需新建一个固定地址的服务（如：intent-service），服务指向127.0.0.1:80 （即自身网关实例+端口），ai-intent插件内部需要该服务进行调用，以访问上述新增的路由,服务名对应 llm.proxyServiceName（也可以新建DNS类型服务，使插件访问其他大模型）

4.如果使用固定地址的服务调用网关自身，需把127.0.0.1加入到网关的访问白名单中

名称	数据类型	填写要求	默认值	描述
scene.category	string	必填	-	预设场景类别，以`
scene.prompt	string	非必填	你是一个智能类别识别助手，负责根据用户提出的问题和预设的类别，确定问题属于哪个预设的类别，并给出相应的类别。用户提出的问题为:%s,预设的类别为%s，直接返回一种具体类别，如果没有找到就返回'NotFound'。	llm请求prompt模板
llm.proxyServiceName	string	必填	-	新建的higress服务，指向大模型 (取higress中的 FQDN 值)
llm.proxyUrl	string	必填	-	大模型路由请求地址全路径，可以是网关自身的地址，也可以是其他大模型的地址（openai协议），例如：http://127.0.0.1:80/intent/compatible-mode/v1/chat/completions
llm.proxyDomain	string	非必填	proxyUrl中解析获取	大模型服务的domain
llm.proxyPort	string	非必填	proxyUrl中解析获取	大模型服务端口号
llm.proxyApiKey	string	非必填	-	当使用外部大模型服务时需配置 对应大模型的 API_KEY
llm.proxyModel	string	非必填	qwen-long	大模型类型
llm.proxyTimeout	number	非必填	10000	调用大模型超时时间，单位ms，默认：10000ms

配置示例

scene:
  category: "金融|电商|法律|Higress"
  prompt: "你是一个智能类别识别助手，负责根据用户提出的问题和预设的类别，确定问题属于哪个预设的类别，并给出相应的类别。用户提出的问题为:'%s',预设的类别为'%s'，直接返回一种具体类别，如果没有找到就返回'NotFound'。"
llm:
  proxyServiceName: "intent-service.static"
  proxyUrl: "http://127.0.0.1:80/intent/compatible-mode/v1/chat/completions"
  proxyDomain: "127.0.0.1"
  proxyPort: "80"
  proxyModel: "qwen-long"
  proxyApiKey: ""
  proxyTimeout: "10000"