Appearance
能力介绍
ChatPPT
build_ppt ──▶ query_ppt ──▶
├─ status=1 → 继续轮询 query_ppt
├─ status=2 →
│ ├─▶ download_ppt
│ ├─▶ editor_ppt
│ ├─▶ ppt_replace_template(更换模板) ──▶ query_ppt(重新查询新模板生成状态)
│ │ ├─ status=1 → 继续轮询 query_ppt
│ │ ├─ status=2 →
│ │ │ ├─▶ download_ppt
│ │ │ └─▶ editor_ppt
│ │ └─ status=3 → 失败,提示用户
│ ├─▶ ppt_set_color(设置主题色) ──▶ query_ppt(重新查询设置后的生成状态)
│ │ ├─ status=1 → 继续轮询 query_ppt
│ │ ├─ status=2 →
│ │ │ ├─▶ download_ppt
│ │ │ └─▶ editor_ppt
│ │ └─ status=3 → 失败,提示用户
│ ├─▶ ppt_set_font_name(设置字体) ──▶ query_ppt(重新查询设置后的生成状态)
│ │ ├─ status=1 → 继续轮询 query_ppt
│ │ ├─ status=2 →
│ │ │ ├─▶ download_ppt
│ │ │ └─▶ editor_ppt
│ │ └─ status=3 → 失败,提示用户
│ ├─▶ ppt_set_anim(设置动画) ──▶ query_ppt(重新查询设置后的生成状态)
│ │ ├─ status=1 → 继续轮询 query_ppt
│ │ ├─ status=2 →
│ │ │ ├─▶ download_ppt
│ │ │ └─▶ editor_ppt
│ │ └─ status=3 → 失败,提示用户
│ ├─▶ ppt_create_note(生成演讲稿) ──▶ query_ppt(重新查询生成状态)
│ │ ├─ status=1 → 继续轮询 query_ppt
│ │ ├─ status=2 →
│ │ │ ├─▶ download_ppt
│ │ │ └─▶ editor_ppt
│ │ └─ status=3 → 失败,提示用户
│ ├─▶ ppt_add_slides(插入新页面) ──▶ query_ppt(重新查询生成状态)
│ │ ├─ status=1 → 继续轮询 query_ppt
│ │ ├─ status=2 →
│ │ │ ├─▶ download_ppt
│ │ │ └─▶ editor_ppt
│ │ └─ status=3 → 失败,提示用户
│ ├─▶ ppt_create_outline_text(生成大纲)(不依赖状态查询)
│ └─▶ ppt_create_template_cover_image(生成模板预览图)(不依赖状态查询)
│ └─▶ ppt_replace_user_select_template(替换为指定模板) ──▶ query_ppt(重新查询生成状态)
│ ├─ status=1 → 继续轮询 query_ppt
│ ├─ status=2 →
│ │ ├─▶ download_ppt
│ │ └─▶ editor_ppt
│ └─ status=3 → 失败,提示用户
└─ status=3 → 失败,提示用户
1. API Key 查询check
输入 | 无 |
---|---|
输出 | 用户当前配置的 API Key。 |
功能描述 | 查询用户当前配置的 API Key,用于验证和使用 API 服务。 |
使用场景 | 在使用其他需要 API Key 认证的工具之前,先调用此工具确保 API Key 配置正确。 |
2. PPT 生成进度查询query_ppt
输入 | ppt_id (str):PPT 任务的 ID。 |
---|---|
输出 | PPT 信息的描述,包含生成状态(status )和预览 URL(process_url )等。 |
功能描述 | 根据 PPT 任务 ID 查询异步生成结果,状态 status=1 表示还在生成中,应继续轮询;status=2 表示成功;status=3 表示失败。成功后可打开 PPT 地址并调用下载和编辑工具。 |
使用场景 | 在调用 build_ppt 、build_ppt_by_file 或 build_thesis_ppt 等生成工具后,需要了解 PPT 生成进度时调用。 |
3. 主题生成 PPTbuild_ppt
输入 | text (str):描述生成文本,可为文本或 Markdown。 |
---|---|
输出 | PPT-ID。 |
功能描述 | 根据描述的文本或 Markdown 执行生成任务,返回 PPT-ID 表示生成任务成功,可调用 query_ppt 工具查询生成进度和预览 URL。 |
使用场景 | 当用户希望根据给定的主题文本生成 PPT 时调用。 |
4. 文件生成 PPTbuild_ppt_by_file
输入 | file_url (str):用户上传文件的 URL 地址,支持 MarkDown、word、PDF、XMind、FreeMind、TXT 等文档文件。 |
---|---|
输出 | PPT-ID。 |
功能描述 | 根据用户上传的文件 URL 执行生成 PPT 的任务,返回 PPT-ID 表示生成任务成功,可调用 query_ppt 工具查询生成进度和预览 URL。 |
使用场景 | 当用户有现成的文档文件,希望将其转换为 PPT 时调用。 |
5. 论文生成 PPTbuild_thesis_ppt
输入 | file_url (str):用户的论文文件地址 URL,仅支持 pdf、word 文件。 |
---|---|
输出 | PPT-ID。 |
功能描述 | 根据用户上传的论文文件 URL 执行生成答辩 PPT 的任务,返回 PPT-ID 表示生成任务成功,可调用 query_ppt 工具查询生成进度和预览 URL。 |
使用场景 | 当用户需要将论文文件转换为答辩 PPT 时调用。 |
6. PPT 下载地址生成download_ppt
输入 | ppt_id (str):已生成完成的 PPT 任务的 ID。 |
---|---|
输出 | PPT 下载地址的 URL。 |
功能描述 | 当 PPT 生成完成后,根据 PPT-ID 生成下载 PPT 的地址,方便用户下载到本地。 |
使用场景 | 在 query_ppt 工具查询到 PPT 生成成功后,需要下载 PPT 时调用此工具。 |
7. 编辑器链接生成editor_ppt
输入 | ppt_id (str):已生成完成的 PPT 任务的 ID。 |
---|---|
输出 | PPT 编辑器地址的 URL。 |
功能描述 | 基于生成后的文件,打开并展示 PPTX 文件,方便进行在线编辑与浏览查看。 |
使用场景 | 在 query_ppt 工具查询到 PPT 生成成功后,需要在线编辑或浏览 PPT 时调用此工具。 |
8. 随机替换 PPT 模板ppt_replace_template
输入 | ppt_id (str):PPT 任务的 ID。 |
---|---|
输出 | 新的 PPT-ID。 |
功能描述 | 根据任务 PPT-ID 执行随机替换 PPT 模板,并返回新的任务 PPT-ID,可调用 query_ppt 工具查询生成进度和预览 URL。 |
使用场景 | 当用户对生成的 PPT 模板不满意,希望随机更换模板时调用。 |
9. 设置 PPT 主题色ppt_set_color
输入 | ppt_id (str):PPT 任务的 ID;color (str):设置的主题色,支持颜色空间名称或颜色值。 |
---|---|
输出 | 新的 PPT-ID。 |
功能描述 | 根据 PPT-ID 执行设置更换主题色,并返回新的 PPT-ID,可调用 query_ppt 工具查询生成进度和预览 URL。 |
使用场景 | 当用户希望更改 PPT 的主题色时调用。 |
10. 设置 PPT 字体ppt_set_font_name
输入 | ppt_id (str):PPT 任务的 ID;font_name (str):字体名,如黑体、宋体等。 |
---|---|
输出 | 新的 PPT-ID。 |
功能描述 | 根据 PPT-ID 执行设置 PPT 字体,并返回新的 PPT-ID,可调用 query_ppt 工具查询生成进度和预览 URL。 |
使用场景 | 当用户希望更改 PPT 的字体时调用。 |
11. 设置 PPT 动画ppt_set_anim
输入 | ppt_id (str):PPT 任务的 ID;set_anim (str):是否设置动画,“1” 表示设置,“0” 表示取消。 |
---|---|
输出 | 新的 PPT-ID。 |
功能描述 | 根据 PPT-ID 执行设置或取消 PPT 的动画效果,并返回新的 PPT-ID,可调用 query_ppt 工具查询生成进度和预览 URL。 |
使用场景 | 当用户需要设置或取消 PPT 的动画效果时调用。 |
12. 生成 PPT 演讲稿ppt_create_note
输入 | ppt_id (str):PPT 任务的 ID。 |
---|---|
输出 | 新的 PPT-ID。 |
功能描述 | 参照给出的任务 PPT-ID 自动为用户的 PPT 生成全文演讲稿,并返回新的 PPT-ID,可调用 query_ppt 工具查询生成进度和预览 URL。 |
使用场景 | 当用户需要为生成的 PPT 生成演讲稿时调用。 |
13. 插入新增 PPT 页面ppt_add_slides
输入 | ppt_id (str):PPT 任务的 ID;slide_text (str):用户指定插入页数;slide_type (str):指定生成页面类型,默认为内容页。 |
---|---|
输出 | 新的 PPT-ID。 |
功能描述 | 参照给出的任务 PPT-ID,给对应的文档新增或插入新的 PPT 页面,并返回新的 PPT-ID,可调用 query_ppt 工具查询生成进度和预览 URL。 |
使用场景 | 当用户需要在已生成的 PPT 中新增或插入页面时调用。 |
14. 生成 PPT 大纲ppt_create_outline_text
输入 | ppt_text (str):用户输入的主题文本。 |
---|---|
输出 | 大纲文本内容。 |
功能描述 | 根据用户输入的内容实时生成大纲内容,直接返回大纲文本内容。 |
使用场景 | 当用户需要根据主题文本生成 PPT 大纲时调用。 |
15. 生成 PPT 模板预览图ppt_create_template_cover_image
输入 | ppt_text (str):用户输入主题文本;ppt_color (list [str]):指定生成的模板风格,可选;ppt_style (str):指定生成模板的颜色,可选;ppt_num (int):指定生成模板数量,默认为 4。 |
---|---|
输出 | 模板 ID 和对应的渲染图片。 |
功能描述 | 根据用户输入的内容实时生成与渲染对应的模板,返回对应的模板 ID 和对应的渲染图片,支持用户指定颜色和风格,默认随机。 |
使用场景 | 当用户需要选择合适的 PPT 模板时调用。 |
16. 替换为指定模板ppt_replace_user_select_template
输入 | ppt_id (str):PPT 任务的 ID;cover_id (str):用户指定的模板 ID,需通过 ppt_create_template_cover_image 生成。 |
---|---|
输出 | 新的 PPT-ID。 |
功能描述 | 根据任务 PPT-ID 执行替换为用户指定的模板,并返回新的任务 PPT-ID,可调用 query_ppt 工具查询生成进度和预览 URL。 |
使用场景 | 当用户在 ppt_create_template_cover_image 中选择了合适的模板后,希望将 PPT 替换为该模板时调用。 |
智能简历
build_resume ──▶(生成简历并返回预览/下载)
write ──▶ 对简历内容进行润色 / 扩写 / 精炼 等处理
recognize ──▶(上传已有简历)──▶ analyse_data ──▶ resume_style_write
↑
│
对接 JD 内容优化
match ──▶(岗位匹配)──▶ info(查看匹配分析报告)
check ──▶ 查询当前 API Key 配置状态
1. 鉴权查询check
输入 | 无 |
---|---|
输出 | 用户当前配置的 API Key |
功能描述 | 查询用户当前配置 token |
使用场景 | 需要确认 API Key 是否正确配置时 |
2.简历生成 build_resume
输入 | text (生成简历的查询语句)、name (个人简历姓名,可选)、mobile (个人简历手机号,可选)、job (个人工作岗位,可选)、school (个人简历学校,可选)、major (个人简历专业,可选)、work_year (个人简历工作年限,可选)、company (个人简历公司,可选)、gender (性别,可选)、age (个人简历年龄,可选) |
---|---|
输出 | 显示简历信息与图片,并下载简历 |
功能描述 | 根据输入参数,生成一份简历文档,除了 text 字段必须,其他可以为空字符,当成功后使用默认浏览器打开简历地址并下载简历 |
使用场景 | 用户需要快速生成一份简历时 |
3. 岗位匹配match
输入 | job_title (岗位名称)、job_desc (岗位描述)、resume_url (简历 URL,可选) |
---|---|
输出 | 分析 ID(requestId ) |
功能描述 | 通过岗位名称、岗位描述、简历 URL 进行人岗匹配,返回分析 ID |
使用场景 | 招聘过程中评估候选人与岗位匹配度时 |
4. 获取匹配报告info
输入 | request_id (分析 ID) |
---|---|
输出 | 返回分析结果 |
功能描述 | 通过分析 ID 获取简历匹配报告 |
使用场景 | 完成人岗匹配后查看具体分析报告时 |
5. 简历辅写write
输入 | text (处理的文本)、task (任务类型,如 1 润色,2 扩写等)、scene (场景,如 "JD","工作经历" 等)、job (岗位,可选)、industry (行业,可选)、channels (渠道,可选,默认 "社会招聘")、company (公司名称,可选) |
---|---|
输出 | 返回辅写结果 |
功能描述 | 集成多种辅写服务(润色、扩写、精炼、续写、短词成文),结合用户指定的所属行业、岗位及具体场景,生成符合职业要求的简历内容 |
使用场景 | 用户需要对简历内容进行优化、完善时 |
6.简历解析 recognize
输入 | file (上传的文件路径) |
---|---|
输出 | 返回解析结果 |
功能描述 | 简历解析工具,分析简历数据内容,通过 analyse_data 使简历内容根据 JD 分析处理优化,最后通过优化后内容结构生成简历 |
使用场景 | 需要将已有简历文件进行解析并进一步优化时 |
7.简历优化 analyse_data
输入 | recognize_data (简历识别内容)、jd (JD 内容) |
---|---|
输出 | 返回解析结果 |
功能描述 | 根据识别简历结构和用户输入的 JD 信息重新整理美化简历内容 |
使用场景 | 完成简历解析后根据具体岗位描述对简历进行优化时 |
8.简历美化resume_style_write
输入 | color (颜色,如红色、橙色等)、modules (简历解析的结构) |
---|---|
输出 | 简历地址 |
功能描述 | 根据简历结构重新生成简历 |
使用场景 | 完成简历解析和内容优化后生成一份新简历时 |