feat: 支持 Python 直通模式

Signed-off-by: Ke Jie <[email protected]>
open-dingtalk · Nov 6, 2024 · 8340ad3 · 8340ad3
1 parent 0140166
commit 8340ad3
Show file tree

Hide file tree

Showing 17 changed files with 630 additions and 7 deletions.
diff --git a/...xplore/tutorials/assistant_ability/passthrough_mode/java/create_ai_assistant.md b/...xplore/tutorials/assistant_ability/passthrough_mode/java/create_ai_assistant.md
@@ -4,4 +4,8 @@ sidebar_position: 2
 
 # 2. 创建 AI 助理
 
-首先我们需要再钉钉客户端创建一个 AI 助理，创建 AI 助理的过程可以参考钉钉的官方文档[创建组织内使用的 AI 助理](https://open.dingtalk.com/document/ai-dev/create-a-dingtalk-ai-assistant)
+首先我们需要再钉钉客户端创建一个 AI 助理，创建 AI 助理的过程可以参考钉钉的官方文档[创建组织内使用的 AI 助理](https://open.dingtalk.com/document/ai-dev/create-a-dingtalk-ai-assistant)和[创建市场 AI 助理](https://open.dingtalk.com/document/ai-dev/creative-dingtalk-ai-assistant)。
+
+这两种创建渠道的区别是：
+1. 前者适合企业员工使用
+2. 后者可以发布到钉钉助理市场，可以在钉钉 AI 助理市场中找到对应的 AI 助理
diff --git a/docs/explore/tutorials/assistant_ability/passthrough_mode/java/intro.md b/docs/explore/tutorials/assistant_ability/passthrough_mode/java/intro.md
@@ -15,4 +15,8 @@ sidebar_position: 1
 ## 准备工作
 
 1. 钉钉账号，获得开发者权限。关于开发者权限，你可以通过[这篇文章](/docs/explore/portal/grant-admin)获得相关操作指南；
-2. Java 开发环境
+2. Java 开发环境：[Java SE Development Kit (JDK)](https://dev.java/) 和 [Maven](https://maven.apache.org/)
+
+:::tip
+相关代码在 Java 8 版本中通过了测试。在旧版本中通常也是可以工作的，但是未经过测试，推荐采用最新版本。
+:::
diff --git a/docs/explore/tutorials/assistant_ability/passthrough_mode/java/open_passthrough.md b/docs/explore/tutorials/assistant_ability/passthrough_mode/java/open_passthrough.md
@@ -9,8 +9,8 @@ import TabItem from '@theme/TabItem';
 
 ### 步骤一: 创建自定义能力
 
-![img.png](create1.png)
-![img.png](create2.png)
+![create1.png](/img/explore/assistant/passthrough/create1.png)
+![create2.png](/img/explore/assistant/passthrough/create2.png)
 
 ### 步骤二: 编写接口的 Yaml 描述文件，我们这里以天气查询为例
 :::caution注意事项

diff --git a/docs/explore/tutorials/assistant_ability/passthrough_mode/java/体验直通模式AI助理.md b/docs/explore/tutorials/assistant_ability/passthrough_mode/java/体验直通模式AI助理.md
@@ -11,11 +11,11 @@ import TabItem from '@theme/TabItem';
 
 ## 魔法棒
 打开钉钉客户端右上角的魔法棒，找到对应的 AI 助理和助理进行对话即可
-![img.png](魔法棒体验.png)
+![img.png](../../../../../../static/img/explore/assistant/passthrough/魔法棒体验.png)
 
 ## IM 单例/群聊
 如果想要在 IM 中和 AI 助理进行对话，需要将 AI 助理发布为组织内使用
-![img.png](发布成组织可用.png)
+![img.png](../../../../../../static/img/explore/assistant/passthrough/发布成组织可用.png)
 
 找到 AI 助理之后和 AI 助理对话
-![img.png](IM体验.png)
+![img.png](../../../../../../static/img/explore/assistant/passthrough/IM体验.png)
diff --git a/docs/explore/tutorials/assistant_ability/passthrough_mode/python/_category_.json b/docs/explore/tutorials/assistant_ability/passthrough_mode/python/_category_.json
@@ -0,0 +1,8 @@
+{
+  "label": "Python",
+  "position": 2,
+  "link": {
+    "type": "generated-index",
+    "slug": "/explore/tutorials/assistant_ability/passthrough_mode/python"
+  }
+}
diff --git a/docs/explore/tutorials/assistant_ability/passthrough_mode/python/step-1-intro.md b/docs/explore/tutorials/assistant_ability/passthrough_mode/python/step-1-intro.md
@@ -0,0 +1,21 @@
+---
+sidebar_position: 1
+---
+
+# 1. 介绍
+
+本文以及接下来的步骤指引，介绍如何通过直通模式模式开发 AI 助理自定义能力。
+
+## 功能
+
+通过这个教程，你可以学会
+1. 如何开通 AI 助理直通模式
+2. 如何开发 AI 助理服务端代码
+
+## 准备工作
+
+1. [Python](https://www.python.org/) 开发环境，推荐采用 3.11 及以上版本
+
+:::tip
+相关代码在 Python 3.11.5 版本中通过了测试。在旧的 Python3 中通常也是可以工作的，但是未经过测试，推荐采用最新版本。
+:::
diff --git a/docs/explore/tutorials/assistant_ability/passthrough_mode/python/step-2-create.md b/docs/explore/tutorials/assistant_ability/passthrough_mode/python/step-2-create.md
@@ -0,0 +1,11 @@
+---
+sidebar_position: 2
+---
+
+# 2. 创建 AI 助理
+
+首先我们需要再钉钉客户端创建一个 AI 助理，创建 AI 助理的过程可以参考钉钉的官方文档[创建组织内使用的 AI 助理](https://open.dingtalk.com/document/ai-dev/create-a-dingtalk-ai-assistant)和[创建市场 AI 助理](https://open.dingtalk.com/document/ai-dev/creative-dingtalk-ai-assistant)。
+
+这两种创建渠道的区别是：
+1. 前者适合企业员工使用
+2. 后者可以发布到钉钉助理市场，可以在钉钉 AI 助理市场中找到对应的 AI 助理