# 智能助手：从自然语言到可执行代码

[飞书开放平台智能助手](https://open.feishu.cn/app/ai/playground) 为开发者提供安全隔离的多语言代码运行环境，告别繁琐的本地环境搭建，让原型验证和代码调试变得高效便捷。你只需用自然语言描述具体需求，即可生成高质量代码，并一键在沙箱中运行与调试。

## 核心能力

- **自然语言生成代码**：将需求描述直接转换为高质量、可执行的代码。
- **多语言支持**：覆盖 Node.js、 Python、 Go、Java，可灵活切换以满足不同技术栈需求。
- **环境免配置**：沙箱内置各语言官方 `lark-oapi` SDK 与主流依赖，开箱即用。
- **实时运行与调试：** 在控制台实时查看代码的输出日志和执行结果。

## 支持的语言与库

为确保环境的一致性与安全，沙箱提供了各语言的特定版本和预装库。
仅能使用预装的依赖，不支持安装其他库。

语言 | 版本 | 预装库
---|---|---
Node.js | 22.14.0 | ```json <br>{<br>"@larksuiteoapi/node-sdk": "^1.43.0",<br>"axios": "^1.8.1",<br>"lodash": "^4.17.21",<br>"node-fetch": "^3.3.2",<br>"axios-retry": "^4.5.0"<br>}<br>```
Python | 3.11.2 | ```json <br>lark-api>=1.4.8<br>requests==2.31.0 <br>```
Go | 1.23.3 | ```json <br>github.com/larksuite/oapi-sdk-go/v3@v3.4.10  // 飞书开放平台SDK<br>github.com/gorilla/websocket@v1.5.0        // WebSocket支持<br>github.com/gogo/protobuf@v1.3.2           // Protocol Buffers <br>```
Java | JDK 21 | ```json <br><dependency><br><groupId>com.larksuite.oapi</groupId><br><artifactId>oapi-sdk</artifactId><br><version>2.4.20</version><br></dependency><br><dependency><br><groupId>com.google.code.gson</groupId><br><artifactId>gson</artifactId><br><version>2.13.1</version><br></dependency><br><dependency><br><groupId>ch.qos.logback</groupId><br><artifactId>logback-classic</artifactId><br><version>1.2.3</version><br></dependency><br>```

## 环境与资源限制

为了保证环境的安全、稳定和公平使用，代码沙箱在以下方面进行了限制：

类别 | 限制
---|---
业务范围 | - 仅支持 [服务端 API 及事件](https://open.feishu.cn/document/ukTMukTMukTM/ukDNz4SO0MjL5QzM/AI-assistant-code-generation-guide )，不支持客户端（如：小程序、网页应用、小组件等）代码生成与调试。<br>- 不支持历史文档相关代码生成及知识问答。
网络访问 | 仅允许访问飞书开放平台相关域名，即 `open.feishu.cn`、`msg-frontier.feishu.cn`。<br>- 无法访问任何其他外部网络或服务。<br>- 环境无入站连接。
文件系统 | 仅支持临时、只读的工作目录：<br>- 不支持上传、创建或删除文件。<br>- 无法访问宿主机文件系统。<br>- 无持久化存储：每次执行结束后，环境和所有临时文件将被自动清理和重置。
计算资源 | - CPU：0.5 核<br>- 内存：1 GB，超出内存限制的进程将被强制终止。
执行时长 | 代码运行时间最长 5 分钟，执行超过 5 分钟的任务将被超时中断。
代码部署 | 不支持托管代码，需自行部署代码到对应环境。
系统权限 | 受限的系统调用：无法执行需要高权限的系统级操作，以确保环境安全。

## 如何使用

只需用自然语言告诉开放平台智能助手你的具体需求，即可生成基于飞书服务端 API 的代码，一键在沙箱中安全运行与调试。

1. **描述需求**：在 [智能助手](https://open.feishu.cn/app/ai/playground?from=nav&lang=zh-CN) 输入框中，用清晰具体的自然语言描述需求。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/1150c0ebb1c12c9dcee8182ce1d291a2_OAPDL1iZcC.png?height=1850&lazyload=true&maxWidth=450&width=1850)

1. **生成与配置**：选择要生成的代码语言，然后点击 **继续下一步**，智能助手将立即生成代码。代码生成后，还需要完成应用运行前的配置和发布。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/54871b4e7443a9375a107253eafc29e0_n5DpkW3FLI.png?height=1958&lazyload=true&maxWidth=350&width=1936) | ![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/ae85f4e4d8905f4946756a3f77cea368_YVn1q4dlLE.png?height=1978&lazyload=true&maxWidth=550&width=3880)
---|---

3. **运行与验证**：点击 **立即运行** 按钮，在底部的**控制台**中实时查看执行结果，验证是否符合预期。

![](//sf3-cn.feishucdn.com/obj/open-platform-opendoc/f477277136769652454e81616d83c2fc_7978w7F5jB.png?height=1888&lazyload=true&maxWidth=450&width=3702)

