diff --git a/docs/best-practice/integration.md b/docs/best-practice/integration.md index 1351d8ba50c44bbf43f33e5d5e1f4aa7ac5ad421..393f0132f8dc411ba394c6bde6bbfaed39951442 100644 --- a/docs/best-practice/integration.md +++ b/docs/best-practice/integration.md @@ -1,84 +1,61 @@ # Serverless API 应用集成指南 - - -[Serverless API](https://ai.gitee.com/serverless-api) 提供了六大类、数十个模型 API，只需调用 API 就可以将其强大的功能集成到您的应用中。本文为大家推荐了一些可集成 Serverless API 的应用，以及详细的集成配置指南。 - - +[Serverless API](https://ai.gitee.com/serverless-api) 提供了数量众多的模型 API，只需调用 API 就可以将其强大的功能集成到您的应用中。本文为大家推荐了一些可集成 Serverless API 的应用，以及详细的集成配置指南。 这些应用运行我们日常使用的平台上，如 Windows、mac 上的客户端、网页应用、浏览器插件，移动端 APP 等，通过使用这些应用，即可释放 Serverless API 的模型能力，从而提升您使用 AI 的便捷性。以下是应用的访问地址和简介： -| 分类 | 应用名称 | 简介 | -| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | -| 客户端类 | [Chatbox](https://chatboxai.app/zh) | 一个支持多种流行LLM模型的桌面客户端，可在 Windows、Mac 和 Linux 上使用 | -| | [OpenCat](https://opencat.app/zh-Hans/) | OpenCat 是一个 AI 对话聊天客户端，支持 iOS 和 macOS | -| | [Dify](https://dify.ai/) | 一款开源的大语言模型（LLM） 应用开发平台。它融合了后端即服务和 [LLMOps](https://docs.dify.ai/v/zh-hans/learn-more/extended-reading/what-is-llmops) 的理念，使开发者可以快速搭建生产级的生成式 AI 应用 | -| | [Nextchat](https://nextchat.dev/) | 只需轻点几下，就能在自己的服务器上搭建聊天服务 | -| | [Pal Chat](https://apps.apple.com/us/app/pal-chat-ai-chat-client/id6447545085) | 一款可以在 iPhone 或 iPad 上使用的 AI 助手 | -| | [Enconvo](https://www.enconvo.com/) | Enconvo 是 AI 时代的启动器,是所有AI功能的入口,也是一位体贴的智能助理.】 | -| | [Cherry Studio](https://www.cherrystudios.com/) | 一款为创造者而生的桌面版 AI 助手 | -| 浏览器插件 | [沉浸式翻译](https://immersivetranslate.com/zh-Hans/) | 一款双语对照网页翻译插件，简洁，高效 | -| | [ChatGPT Box](https://github.com/josStorer/chatGPTBox) | 将 LLM 作为私人助手，整合到你的浏览器中 | -| | [划词翻译](https://hcfy.app/) | 整合了多家翻译 API 以及 LLM API 的浏览器翻译插件 | -| | [欧路翻译](https://chromewebstore.google.com/detail/%E6%AC%A7%E8%B7%AF%E7%BF%BB%E8%AF%91-%E7%BD%91%E9%A1%B5%E5%88%92%E8%AF%8D%E7%BF%BB%E8%AF%91%E5%B7%A5%E5%85%B7/djbfechcnkppbknmlhfcaoifgnicolin) | 提供鼠标划词搜索、逐段对照翻译、PDF 文献翻译功能。可以使用支持 DeepSeek AI, Bing、GPT、Google 等多种翻译引擎 | -| IM 助手 | [茴香豆](https://github.com/InternLM/HuixiangDou/blob/main/README_zh.md) | 一个集成到个人微信群/飞书群的领域知识助手，专注解答问题不闲聊 | -| | [QChatGPT](https://github.com/RockChinQ/QChatGPT) | 高稳定性、支持插件、实时联网的 LLM QQ / QQ频道 / One Bot 机器人 | -| VScode 插件 | [Continue](https://github.com/continuedev/continue) | 开源 IDE 插件，使用 LLM 做你的编程助手 | - - +| 分类 | 应用名称 | 简介 | +| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| 客户端类 | [Chatbox](https://chatboxai.app/zh) | 一个支持多种流行LLM模型的桌面客户端，可在 Windows、Mac 和 Linux 上使用 | +| | [OpenCat](https://opencat.app/zh-Hans/) | OpenCat 是一个 AI 对话聊天客户端，支持 iOS 和 macOS | +| | [Dify](https://dify.ai/) | 一款开源的大语言模型（LLM） 应用开发平台。它融合了后端即服务和 [LLMOps](https://docs.dify.ai/v/zh-hans/learn-more/extended-reading/what-is-llmops) 的理念，使开发者可以快速搭建生产级的生成式 AI 应用 | +| | [Nextchat](https://nextchat.dev/) | 只需轻点几下，就能在自己的服务器上搭建聊天服务 | +| | [Pal Chat](https://apps.apple.com/us/app/pal-chat-ai-chat-client/id6447545085) | 一款可以在 iPhone 或 iPad 上使用的 AI 助手 | +| | [Enconvo](https://www.enconvo.com/) | Enconvo 是 AI 时代的启动器,是所有AI功能的入口,也是一位体贴的智能助理.】 | +| | [Cherry Studio](https://www.cherrystudios.com/) | 一款为创造者而生的桌面版 AI 助手 | +| 浏览器插件 | [沉浸式翻译](https://immersivetranslate.com/zh-Hans/) | 一款双语对照网页翻译插件，简洁，高效 | +| | [ChatGPT Box](https://github.com/josStorer/chatGPTBox) | 将 LLM 作为私人助手，整合到你的浏览器中 | +| | [划词翻译](https://hcfy.app/) | 整合了多家翻译 API 以及 LLM API 的浏览器翻译插件 | +| | [欧路翻译](https://chromewebstore.google.com/detail/%E6%AC%A7%E8%B7%AF%E7%BF%BB%E8%AF%91-%E7%BD%91%E9%A1%B5%E5%88%92%E8%AF%8D%E7%BF%BB%E8%AF%91%E5%B7%A5%E5%85%B7/djbfechcnkppbknmlhfcaoifgnicolin) | 提供鼠标划词搜索、逐段对照翻译、PDF 文献翻译功能。可以使用支持 DeepSeek AI, Bing、GPT、Google 等多种翻译引擎 | +| IM 助手 | [茴香豆](https://github.com/InternLM/HuixiangDou/blob/main/README_zh.md) | 一个集成到个人微信群/飞书群的领域知识助手，专注解答问题不闲聊 | +| | [QChatGPT](https://github.com/RockChinQ/QChatGPT) | 高稳定性、支持插件、实时联网的 LLM QQ / QQ频道 / One Bot 机器人 | +| VScode 插件 | [Continue](https://github.com/continuedev/continue) | 开源 IDE 插件，使用 LLM 做你的编程助手 | 以上应用均支持集成 Serverless API，配置操作也很简单，在选择 API 配置的时候，因为 Serverless API 与 OpenAI API 格式兼容，模型提供方只需要选择 OpenAl APl Compatible。这个时候通常需要填写 API 调用地址、API key 等信息，下面是操作步骤： - - ## 操作步骤 - + **1. 获取** **API** **路径：** 请在 Serverless API 页选择你想要使用的模型，点击调用，获取它的 API 调用地址，如下所示： _https:\//ai.gitee.com/api/serverless/<Model>/chat/completions_ - - - ![alt text](../../static/img/serverless-api/integrated/integrate1.png) - - **2. 通过上面获取的路径，通常需要将路径拆分，填写下方信息：** - API Host (Domain)：_https://ai.gitee.com/_ - API Path：_api/serverless/<Model>/chat/completions_ - - ![alt text](../../static/img/serverless-api/integrated/integrate2.png) - - **3. 获取 API key：** 前往 Gitee AI 工作台 - 设置 - 访问令牌，创建你的 API Key ![alt text](../../static/img/serverless-api/integrated/integrate3.png) - 在一些业务场景中，可能需要让客户端直接调用 Serverless API ，这时候需要将 Access Token 传递给客户端，为了安全起见，建议将 Access Token 存储在后端，通过后端服务代理调用 Serverless API。 - 如果希望直接在客户端使用 Access Token ，Gitee AI 提供了创建临时 Token 的接口，该接口的详细使用方法请查看 **[创建临时 Access Token](https://ai.gitee.com/docs/openapi/v1#tag/account/POST/account/temporary-token)** - ## 集成 OpenCat OpenCat 是一个 AI 对话聊天客户端，支持 iOS 和 macOS，在对话框内，可以快速的使用 prompt，展开新的对话，通过对接一些主流平台的 API ，可以选择与多种模型聊天。 - - ### 配置指南 - 1. 下载 [OpenCat](https://opencat.app/zh-Hans/) 2. 进入setting——Providers @@ -93,50 +70,34 @@ OpenCat 是一个 AI 对话聊天客户端，支持 iOS 和 macOS，在对话框 ![alt text](../../static/img/serverless-api/integrated/integrate4.png) - - - - ## 集成沉浸式翻译 - - [Immersive Translate](https://immersivetranslate.com/) 是一款浏览器插件，专注于提供高效的双语对照翻译服务。它支持网页、PDF、EPUB 等多种格式的翻译，能够实时翻译外语内容，并支持视频双语字幕翻译。插件提供了便捷的鼠标悬停翻译和输入框翻译功能，是提升信息获取效率的利器。 - - - - ### **配置指南** - - -1. 安装成功后，进入 Immersive Translate 插件 - “翻译服务”，滑到最底部添加自定义翻译服务。 +1. 安装成功后，进入 Immersive Translate 插件 - “翻译服务”，滑到最底部添加自定义翻译服务。 -![alt text](../../static/img/serverless-api/integrated/integrate5.png) +![alt text](../../static/img/serverless-api/integrated/integrate5.png) 2. 在设置页面输入以下关键信息： + - 自定义 API 接口地址： _此处填写 Serverless API 完整的调用地址_ - APIKEY：在 Gitee AI 工作台 - 设置 - 访问令牌，复制访问令牌（API key） - 每秒最大请求数：1 - 每次请求最大文本长度：1200 - 每次请求最大段落数：8 - 3. 点击页面上方“点此测试服务”，显示“验证成功”即配置完成 ![alt text](../../static/img/serverless-api/integrated/integrate6.png) - ## 集成 Dify - Dify 是一款开源的大语言模型（LLM)）应用开发平台。它融合了后端即服务（Backend as Service）和 [LLMOps](https://docs.dify.ai/v/zh-hans/learn-more/extended-reading/what-is-llmops) 的理念，使开发者可以快速搭建生产级的生成式 AI 应用。即使是非技术人员，也能参与到 AI 应用的定义和数据运营过程中。 ### 配置指南 - - Serverless API 支持在 Dify 中调用，使用步骤如下 1. 获取 Gitee AI 访问令牌 @@ -161,41 +122,26 @@ Serverless API 支持在 Dify 中调用，使用步骤如下 ![](../../static/img/serverless-api/integrated/integrate17.png) - - ## 集成 Nextchat [Nextchat](https://nextchat.dev/) 是一款网页端的 AI 对话工具，支持自定义大模型。还支持在自己的服务器上搭建聊天服务。 - - ### 配置指南 1. 点击设置，并滚动至自定义接口，选择 OpenAI 2. Serverless API 链接，在调用窗口获取，填写完整 URL，示例：_https://ai.gitee.com/api/serverless/Qwen2-7B-Instruct/chat/completions_ - - ![alt text](../../static/img/serverless-api/integrated/integrate10.png) - 3. 最后，创建新聊天，点击对话设置，选择刚刚配置的模型，就可以在对话框内调用模型了。 ![alt text](../../static/img/serverless-api/integrated/integrate11.png) ![alt text](../../static/img/serverless-api/integrated/integrate12.png) - - - - ## 集成 ChatGPTBox - -[ChatGPT Box](https://github.com/josStorer/chatGPTBox) 是一款浏览器插件，支持在浏览器内随时呼出 AI 对话框，并适用于手机端浏览器。支持自定义模型 API，它还提供框选内容执行任务、静态卡片浮出聊天框、代码高亮和复杂公式渲染、对话记录保存等功能。 - - - +[ChatGPT Box](https://github.com/josStorer/chatGPTBox) 是一款浏览器插件，支持在浏览器内随时呼出 AI 对话框，并适用于手机端浏览器。支持自定义模型 API，它还提供框选内容执行任务、静态卡片浮出聊天框、代码高亮和复杂公式渲染、对话记录保存等功能。 ### 配置指南 @@ -212,8 +158,8 @@ Serverless API 支持在 Dify 中调用，使用步骤如下 [Continue](https://github.com/continuedev/continue) 是领先的开源 AI 代码助手。您可以连接任何模型和任何上下文，在 VS Code 和 JetBrains 中构建自定义自动完成和聊天体验。 - ### 配置指南 + 在 VS Code 和 JetBrains 安装 continue 的扩展之后，按照一下要求操作 serverless API 提供 [OpenAI compatible API ](https://docs.continue.dev/customize/model-providers/openai#openai-compatible-servers--apis)，以 deepseek 模型为例，使用其他模型可以替换成对应的配置 @@ -246,4 +192,4 @@ serverless API 提供 [OpenAI compatible API ](https://docs.continue.dev/customi ... ``` -更多应用，请查看文章顶部表格，如有疑问或建议，请随时[联系我们](https://ai.gitee.com/about)。 \ No newline at end of file +更多应用，请查看文章顶部表格，如有疑问或建议，请随时[联系我们](https://ai.gitee.com/about)。 diff --git a/docusaurus.config.ts b/docusaurus.config.ts index 8f2825ab0cd855db0804192574a14bb32a06a08f..b5186b9c19f36502682b9ec23dab66809a405b35 100644 --- a/docusaurus.config.ts +++ b/docusaurus.config.ts @@ -80,21 +80,21 @@ const config: Config = { value: '工作台', }, { - label: 'Serverless API', + label: '模型广场', to: 'https://ai.gitee.com/serverless-api', target: '_self', className: 'gai-navbar-item gai-navbar-item-badge', }, { - label: '模型', + label: '模型下载', items: [ { - label: '模型', + label: '模型下载', to: 'https://ai.gitee.com/models', target: '_self', }, { - label: '数据集', + label: '数据集下载', to: 'https://ai.gitee.com/datasets', target: '_self', }, @@ -139,6 +139,16 @@ const config: Config = { { label: '专区', items: [ + { + label: '昇腾计算', + to: 'https://ai.gitee.com/topics/ascend', + target: '_self', + }, + { + label: '昇腾 AI 开发板', + to: 'https://ai.gitee.com/topics/ascend-edge', + target: '_self', + }, { label: '天数智芯', to: 'https://ai.gitee.com/topics/iluvatar', @@ -322,7 +332,7 @@ const config: Config = { }, }, ], - function() { + function () { return { name: 'cdn-image-plugin', configureWebpack(config, isServer) { diff --git a/package.json b/package.json index 73c1d51a54c8072509dcd8ff1c5b8a7df9d5272e..3fd65de8a55aedbbc3d71ffccbce17c3b0e060c0 100644 --- a/package.json +++ b/package.json @@ -52,5 +52,6 @@ }, "engines": { "node": ">=18.0" - } + }, + "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e" } diff --git a/src/css/custom.css b/src/css/custom.css index 6206df63885f14e8e3eaffce3382284670e0c405..e1d5ece6ccf342cc04371fa45f049fdc6834271d 100644 --- a/src/css/custom.css +++ b/src/css/custom.css @@ -22,7 +22,10 @@ --ifm-navbar-second-background-color: rgba(248, 250, 252, 1); --ifm-navbar-button-border-color: rgba(226, 232, 240, 1); --ifm-navbar-button-color: rgba(15, 23, 41, 1); - --ifm-font-family-base: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Noto Sans", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; + --ifm-font-family-base: ui-sans-serif, system-ui, -apple-system, + BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', + sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', + 'Noto Color Emoji'; } /* For readability concerns, you should choose a lighter palette in dark mode. */ @@ -199,7 +202,9 @@ div[id^='headlessui-disclosure-panel'] tr td.relative:nth-child(2) { } .theme-doc-toc-desktop { - top: calc(var(--ifm-navbar-height) + 1rem + var(--ifm-navbar-height)) !important; + top: calc( + var(--ifm-navbar-height) + 1rem + var(--ifm-navbar-height) + ) !important; } .dropdown > .navbar__link:after { @@ -244,7 +249,7 @@ div[id^='headlessui-disclosure-panel'] tr td.relative:nth-child(2) { position: absolute; top: 0; line-height: 0.75rem; - left: 112px; + left: 74px; } .navbar__link--active { @@ -270,13 +275,13 @@ div[id^='headlessui-disclosure-panel'] tr td.relative:nth-child(2) { } .theme-doc-sidebar-container { - margin-top: calc(-1* var(--ifm-navbar-height) * 2) !important; + margin-top: calc(-1 * var(--ifm-navbar-height) * 2) !important; } .theme-doc-sidebar-container > div > div { padding-top: calc(var(--ifm-navbar-height) * 2) !important; } -.theme-doc-markdown.markdown .anchor { - scroll-margin-top: calc(var(--ifm-navbar-height) * 2 + .5rem); +.theme-doc-markdown.markdown .anchor { + scroll-margin-top: calc(var(--ifm-navbar-height) * 2 + 0.5rem); }