feat: chatPPT plugin (#203)

* feat: chatPPT plugin

* feat: add course and input placeholder, handle exception

* feat: use smaller logo file

* chore: simplify throw error out

* chore: simplify request

* fix: add optional type

Author: fishwww-ww

bun.lock

@@ -157,6 +157,18 @@
         "typescript": "^5.0.0",
       },
     },
+    "modules/tool/packages/chatPPT": {
+      "name": "@fastgpt-plugins/tool-chat-ppt",
+      "dependencies": {
+        "zod": "^3.24.2",
+      },
+      "devDependencies": {
+        "@types/bun": "latest",
+      },
+      "peerDependencies": {
+        "typescript": "^5.0.0",
+      },
+    },
     "modules/tool/packages/dalle3": {
       "name": "fastgpt-tools-dalle3",
       "dependencies": {
@@ -750,6 +762,8 @@
 
     "@fastgpt-plugins/tool-base64-decode": ["@fastgpt-plugins/tool-base64-decode@workspace:modules/tool/packages/base64Decode"],
 
+    "@fastgpt-plugins/tool-chat-ppt": ["@fastgpt-plugins/tool-chat-ppt@workspace:modules/tool/packages/chatPPT"],
+
     "@fastgpt-plugins/tool-link-memo": ["@fastgpt-plugins/tool-link-memo@workspace:modules/tool/packages/linkMemo"],
 
     "@fastgpt-plugins/tool-mineru": ["@fastgpt-plugins/tool-mineru@workspace:modules/tool/packages/mineru"],

modules/tool/packages/chatPPT/config.ts

@@ -0,0 +1,61 @@
+import { defineTool } from '@tool/type';
+import { FlowNodeInputTypeEnum, WorkflowIOValueTypeEnum } from '@tool/type/fastgpt';
+import { ToolTypeEnum } from '@tool/type/tool';
+
+export default defineTool({
+  courseUrl: 'https://wiki.yoo-ai.com/api/guide.html',
+  name: {
+    'zh-CN': '必优ChatPPT',
+    en: 'ChatPPT'
+  },
+  type: ToolTypeEnum.tools,
+  description: {
+    'zh-CN': '必优ChatPPT，一键生成PPT',
+    en: 'ChatPPT, one-click generate PPT'
+  },
+  toolDescription: 'ChatPPT, one-click generate PPT',
+  secretInputConfig: [
+    {
+      key: 'apiKey',
+      label: 'API Key',
+      description: '可以在必优官网获取',
+      required: true,
+      inputType: 'secret'
+    }
+  ],
+  versionList: [
+    {
+      value: '0.1.0',
+      description: 'Default version',
+      inputs: [
+        {
+          key: 'text',
+          label: '描述文本',
+          renderTypeList: [FlowNodeInputTypeEnum.input, FlowNodeInputTypeEnum.reference],
+          valueType: WorkflowIOValueTypeEnum.string,
+          description: '生成PPT的描述文本',
+          toolDescription: '生成PPT的描述文本',
+          placeholder: '描述PPT内容, 如: 生成一个关于人工智能的PPT',
+          required: true
+        },
+        {
+          key: 'color',
+          label: '主题色',
+          renderTypeList: [FlowNodeInputTypeEnum.input, FlowNodeInputTypeEnum.reference],
+          valueType: WorkflowIOValueTypeEnum.string,
+          description: 'PPT的主题色',
+          toolDescription: 'PPT的主题色',
+          placeholder: '直接填写自然语言描述主题色, 如: 蓝色'
+        }
+      ],
+      outputs: [
+        {
+          valueType: WorkflowIOValueTypeEnum.string,
+          key: 'preview_url',
+          label: 'PPT的预览URL',
+          description: 'PPT的预览URL'
+        }
+      ]
+    }
+  ]
+});

modules/tool/packages/chatPPT/index.ts

@@ -0,0 +1,10 @@
+import config from './config';
+import { InputType, OutputType, tool as toolCb } from './src';
+import { exportTool } from '@tool/utils/tool';
+
+export default exportTool({
+  toolCb,
+  InputType,
+  OutputType,
+  config
+});

modules/tool/packages/chatPPT/logo.png

@@ -0,0 +1,17 @@
+{
+  "name": "@fastgpt-plugins/tool-chat-ppt",
+  "module": "index.ts",
+  "type": "module",
+  "scripts": {
+    "build": "bun ../../../../scripts/build.ts"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "zod": "^3.24.2"
+  }
+}

modules/tool/packages/chatPPT/package.json

@@ -0,0 +1,75 @@
+import { z } from 'zod';
+import { POST, GET } from '@tool/utils/request';
+
+export const InputType = z.object({
+  apiKey: z.string(),
+  text: z.string(),
+  color: z.string().optional()
+});
+
+export const OutputType = z.object({
+  preview_url: z.string()
+});
+
+type CreatePPTResponse = {
+  id: string;
+  images_url: {
+    url: string;
+    time: number;
+  }[];
+  note_status: number;
+  introduce: string;
+  ppt_title: string;
+  page_count: number;
+  progress: number;
+  status: number;
+  first_image_up_at: string;
+  created_at: string;
+  updated_at: string;
+  state_description: string;
+  process_url: string;
+  preview_url: string;
+};
+
+export async function tool({ apiKey, text, color }: z.infer<typeof InputType>) {
+  const token = `Bearer ${apiKey}`;
+  const CHATPPT_BASE_URL = 'https://saas.api.yoo-ai.com';
+
+  const createPPTRes = await POST<{ data: { id: string } }>(
+    `${CHATPPT_BASE_URL}/apps/ppt-create`,
+    {
+      text,
+      color
+    },
+    {
+      headers: {
+        Authorization: token,
+        'Content-Type': 'application/json'
+      }
+    }
+  );
+  const id = createPPTRes?.data?.data?.id;
+  if (!id || typeof id !== 'string') {
+    return Promise.reject('Failed to create PPT: empty id');
+  }
+
+  const getPPTUrlRes = await GET<{ data: CreatePPTResponse }>(
+    `${CHATPPT_BASE_URL}/apps/ppt-result`,
+    {
+      params: {
+        id
+      },
+      headers: {
+        Authorization: token
+      }
+    }
+  );
+  const preview_url = getPPTUrlRes?.data?.data?.preview_url;
+  if (!preview_url || typeof preview_url !== 'string') {
+    return Promise.reject('Failed to fetch PPT preview url');
+  }
+
+  return {
+    preview_url
+  };
+}

modules/tool/packages/chatPPT/src/index.ts

@@ -0,0 +1,8 @@
+import { expect, test } from 'vitest';
+import tool from '..';
+
+test(async () => {
+  expect(tool.name).toBeDefined();
+  expect(tool.description).toBeDefined();
+  expect(tool.cb).toBeDefined();
+});