金蝶云苍穹-插件开发（四）GPT开发相关插件

我只对GPT开发的相关插件进行讲解，因为我的是插件开发教程，关于GPT的一些提示词的写法，GPT任务的配置，请去金蝶云苍穹的文档和社区内学习。

GPT自定义操作

GPT自定义操作的代码的类要实现 IGPTAction 这个接口，这个接口下只有一个要实现的方法，invokeAction方法，GPT自定义操作的业务功能便是在这个方法内写。

public class GetBooksInfo implements IGPTAction {@Overridepublic Map<String, String> invokeAction(String action, Map<String, String> params) {}
}

先对invokeAction的参数列表进行讲解：

第一个String类型的参数action指的是自定义操作的操作名称，第二个参数params指的是这个GPT操作的输入参数，要获取输入参数只要params.get("输入参数名")就可以获取到对应的参数值。

关于返回值

返回值类型是一个Map类型的变量，在其中的元素中，一个元素就是一个输出参数，key就是输出参数的名称，value就是对应的参数值。

通常，如果是返回给输出参数一个数据，则使用JsonObject类型的变量来储存，只要用其put方法，将要存入的信息放进去就行。最后将这个JsonObject类型的变量用toJsonString变成json信息存到输出参数。

如果是返回给输出参数一组数据，则使用则使用JsonObject类型的变量来储存一个数据，再使用JsonArray来存储一个个JsonObject变量，就完成了一组数据的存储，最后将这个JsonArray类型的变量用toJsonString变成json信息存到输出参数。

注：记得JsonArray和JsonObject要import阿里的fastjson的

案例：找对应书籍的书籍类型的所有数据：

/*** 用于查询书籍信息的插件*/
public class DemoTask implements IGPTAction {@Overridepublic Map<String, String> invokeAction(String action, Map<String, String> params) {Map<String , String> result = new HashMap<>();//如果操作名称相等if ("GET_Library_Books".equalsIgnoreCase(action)) {//获取书籍名称String type = params.get("type");//获取DynamicObject列表，将要获取的字段信息注入DynamicObject[] dys = BusinessDataServiceHelper.load("abq2_books_info","number," +"abq2_textfield," +"type," +"group," +"name," +"abq2_introduction",(new QFilter("type", QCP.equals, type)).toArray());//创建一个JsonArrayJSONArray jsonArray = new JSONArray();for (DynamicObject dynamicObject : dys) {//将每一个书籍的信息加入JSONArrayJSONObject jsonObject = new JSONObject();jsonObject.put("number", dynamicObject.getString("number"));jsonObject.put("abq2_textfield", dynamicObject.getString("abq2_textfield"));jsonObject.put("name", dynamicObject.getString("name"));jsonObject.put("group", dynamicObject.getString("group"));jsonObject.put("abq2_introduction", dynamicObject.getString("abq2_introduction"));jsonArray.add(jsonObject);}System.out.println(jsonArray.toJSONString());//加入resultDynamicObject参数，将JsonArray加入到这个参数当中，然后返回result.put("resultDynamicObject", jsonArray.toJSONString());}return result;}
}

微服务调用

微服务调用是将数据给GPT提示或GPT任务，GPT提示和GPT任务便会根据数据进行执行，然后可以获取到执行后的结果，即将GPT的运行隐形在代码中。

获取相应GPT提示和GPT任务的id

通常有时候会要获取指定的GPT任务的id和GPT提示的id，其实GPT提示和GPT任务也是基础资料，也根据相应的方式获取就行，我这有可以现成的可以复制粘贴过去用的自定义方法，可以参照一下：

获取GPT提示：

 //获取GPT提示的idpublic long getPromptFid(String billNo) {DynamicObject dynamicObject = BusinessDataServiceHelper.loadSingle("gai_prompt","number," +"id",(new QFilter("number", QCP.equals, billNo)).toArray());return dynamicObject.getLong("id");}

 获取GPT任务：

 //获取GPT任务的idpublic long getProcessFid(String billNo) {DynamicObject dynamicObject = BusinessDataServiceHelper.loadSingle("gai_process","number," +"id",(new QFilter("number", QCP.equals, billNo)).toArray());return dynamicObject.getLong("id");}

参数都是指定的GPT提示编码和GPT任务编码。

我这里只讲三个微服务调用的方法：

GaiPromptService的syncCall

这个是调用GPT提示的API，我先展示源码的参数列表：

public Map<String, Object> syncCall(long promptId, String input, Map<String, String> varParams) {

第一个参数是指定GPT提示的id，第二个参数是用户的输入信息（就是对话框要输入的），第三个参数是GPT提示的输入参数的集合（输入参数和这个集合中的元素要对应，不然会报错）。

GPT提示的执行和输出信息的获取：

Map<String, Object> result = DispatchServiceHelper.invokeBizService("ai", "gai", "GaiPromptService", "syncCall", params);
JSONObject jsonObjectResult = new JSONObject(result);
JSONObject jsonObjectData = jsonObjectResult.getJSONObject("data");
String llmValue = jsonObjectData.getString("llmValue")

GPT提示的执行是靠DispatchServiceHelper.invokeBizService反射执行的，最后的llmValue就是GPT提示的输出信息

案例：日任务总结：

/*** 用于智能总结日任务情况*/
public class EvaluateSum extends AbstractBillPlugIn {@Overridepublic void registerListener(EventObject e) {//注册点击事件super.registerListener(e);this.addItemClickListeners("tbmain");}public void itemClick(ItemClickEvent e) {super.itemClick(e);if (e.getItemKey().equalsIgnoreCase("abq2_evaluate")) {//获取日任务信息，并且以JSON字符串的形式展现JSONObject jsonResultObject = new JSONObject();jsonResultObject.put("taskName", this.getModel().getValue("name").toString());jsonResultObject.put("createTime", this.getModel().getValue("abq2_task_create_time").toString());//获取当前页面的单据体的数据DynamicObjectCollection dynamicObjectCollection = this.getModel().getEntryEntity("abq2_task_entryentity");JSONArray jsonTaskArray = new JSONArray();for (DynamicObject dynamicObjectSingle : dynamicObjectCollection) {JSONObject jsonObjectSingle = new JSONObject();jsonObjectSingle.put("taskContent", dynamicObjectSingle.getString("abq2_task_context"));jsonObjectSingle.put("expectTime", dynamicObjectSingle.getString("abq2_expect_minute"));jsonObjectSingle.put("diff", dynamicObjectSingle.getString("abq2_diff"));jsonObjectSingle.put("finishTime", dynamicObjectSingle.getString("abq2_true_minute"));jsonObjectSingle.put("finishSituation", dynamicObjectSingle.getString("abq2_finish"));jsonTaskArray.add(jsonObjectSingle);}jsonResultObject.put("taskIntroduction", jsonTaskArray);//调用GPT开发平台微服务Map<String , String> variableMap = new HashMap<>();variableMap.put("taskResult", jsonResultObject.toJSONString());Object[] params = new Object[] {//GPT提示编码getPromptFid("prompt-24052235A7AD28"),"",variableMap};Map<String, Object> result = DispatchServiceHelper.invokeBizService("ai", "gai", "GaiPromptService", "syncCall", params);JSONObject jsonObjectResult = new JSONObject(result);JSONObject jsonObjectData = jsonObjectResult.getJSONObject("data");//设置值this.getModel().setValue("abq2_evaluate_and_sum", jsonObjectData.getString("llmValue"));Markdown mk = this.getView().getControl("abq2_markdownap");mk.setText(jsonObjectData.getString("llmValue"));}}//获取GPT提示的Fidpublic long getPromptFid(String billNo) {DynamicObject dynamicObject = BusinessDataServiceHelper.loadSingle("gai_prompt","number," +"id",(new QFilter("number", QCP.equals, billNo)).toArray());return dynamicObject.getLong("id");}@Overridepublic void afterBindData(EventObject eventObject) {Markdown mk = this.getView().getControl("abq2_markdownap");mk.setText(this.getModel().getValue("abq2_evaluate_and_sum").toString());}
}

剩下两个是GPT任务相关的：

GaiService的selectProcessInSideBar

DispatchServiceHelper.invokeBizService("ai", "gai", "GaiService","selectProcessInSideBar",pkValue,pageId,"……（GPT提示信息）");

这个是在页面中执行后就会弹出GPT对话框，并自动选择好相应的GPT任务的技能的方法。

pkValue就是GPT任务的id，pageId就是当前页面的pageId

示例：（这里的id的获取方式可以参照上面的获取GPT任务的id的自定义方法）

/*** 基础资料插件*/
public class FastShowSchedule extends AbstractBasePlugIn implements Plugin {@Overridepublic void beforeDoOperation(BeforeDoOperationEventArgs e) {super.beforeDoOperation(e);String operateKey = ((FormOperate) e.getSource()).getOperateKey();if (operateKey.equals("showai")){String pageId = this.getView().getMainView().getPageId();//GPT任务的id编码Object pkValue = Long.parseLong("1954601799130295296");DispatchServiceHelper.invokeBizService("ai", "gai", "GaiService","selectProcessInSideBar",pkValue,pageId,"请输入你的日任务内容");}}
}

GaiService的startProcessInSideBar

DispatchServiceHelper.invokeBizService("ai", "gai", "GaiService","startProcessInSideBar",pkValue,pageId,new HashMap(),"……（用户的输入信息）");

中间的那个map是GPT任务要的输入参数，如果没有输入参数可以给个空的集合，使用这个之后，GPT任务会自动运行，但是，弹窗不会自动打开，我也没找到能一起打开弹窗的办法，但是打开弹窗能看到GPT任务已经在对话框输出了，只能先打开对话框，再执行相应的GPT任务。

示例：

@Overridepublic void beforeDoOperation(BeforeDoOperationEventArgs e) {super.beforeDoOperation(e);String operateKey = ((FormOperate) e.getSource()).getOperateKey();if (operateKey.equals("showai")){String pageId = this.getView().getMainView().getPageId();//GPT任务的id编码Object pkValue = Long.parseLong("1969087472054844416");DispatchServiceHelper.invokeBizService("ai", "gai", "GaiService","startProcessInSideBar",pkValue,pageId,new HashMap(),"帮我分析食堂数据");}}