自然语言发起任务

创建任务

1. 参考码道桌面端操作，登录码道CodeArts。
2. 在码道CodeArts客户端的左侧导航栏，选择“新建任务”。
3. 选择工作空间。将任务保存到本地文件夹或者工作空间中，码道CodeArts可以在该目录下读取或生成文件。

   单击输入框下方的“选择工作空间”，您可以选择“新建工作空间”或“打开本地文件夹”。

4. 选择模型。输入框右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。
5. 描述任务。在输入框中使用自然语言描述任务，或者在工作台搭建下方，单击“职场打卡”卡片，自动填充提示词。
   图1 描述任务
   

6. 单击发送图标 ，码道CodeArts会自主完成完整工作流，不仅列出编程思路，还给出了对应的代码实现过程。
7. 结果确认。任务执行完成后，查看任务产物详情，以下截图仅供参考，请以实际生成结果为准。
   • 单击任务产物后面的“查看”，展开右侧产物面板查看效果展示图。
   • 单击“查看所有产物”即可查看该任务生成的所有产物信息。
   • 单击右上角的 展开产物面板，单击右上角的 关闭产物面板。
   • 单击右上角的 全屏显示产物面板。
   图2 查看产物
   

选择智能体运行模式

为了确保代码执行的安全性与灵活性，码道CodeArts为您提供了“沙箱运行”、“自动执行”和“手动审批”三种运行策略。您可以根据业务对安全和自动化的需求进行选择。

1. 单击码道CodeArts左下角的 ，选择“设置”。
2. 在左侧导航栏中，选择“智能体”。
3. 在“终端命令运行模式”中，设置智能体执行终端命令的运行策略。
   图3 终端命令运行模式
   

   表1 运行模式参数说明

   参数	说明
   终端命令运行模式	智能体终端命令的执行策略，您可以根据业务对安全和自动化的需求进行选择。 沙箱运行：终端操作默认在安全沙箱环境中自动运行。 自动执行：智能体直接执行所有命令，无需征得您的同意。 为了确保安全，建议只在必要时启用“自动执行”模式。此模式会绕过所有安全检查，可能在未经提醒的情况下执行高风险操作。 手动审批：智能体执行任何命令前，都会向用户发送确认提示，用户需手动确认后，命令才会继续执行。
   命令白名单	仅“终端命令运行模式”设置为“沙箱运行”时，才显示该配置项。 根据实际需求将特定命令的前缀添加到白名单。被加入白名单的命令将绕过沙箱机制，直接在沙箱外执行。
   沙箱自定义配置	仅“终端命令运行模式”设置为“沙箱运行”时，才显示该配置项。 配置沙箱环境的文件系统和网络访问规则，具体配置方法请参考5。
   网络访问策略	仅“终端命令运行模式”设置为“沙箱运行”时，才显示该配置项。 智能体提供了以下几种网络访问策略供您选择。请依据实际业务需求及安全等级，配置相应的访问控制规则。 允许所有：允许访问所有内部及外部网络资源。 仅允许本地回环：仅允许访问本地服务网络（局域网/内网），禁止通过TCP协议访问外部互联网。Linux沙箱无本地访问策略选项。 禁止所有：阻断所有通过TCP协议建立的网络连接，禁止访问任何内部或外部资源。在Linux系统环境中，Linux沙箱会生成独立模拟地址127.0.0.1，该地址与宿主机本地localhost相互隔离。即使配置禁止网络访问策略，沙箱内部仍可访问该模拟地址，不会被沙箱拦截。 自定义网络访问：通过配置sandbox.json文件，自定义当前项目沙箱环境中进程的网络访问范围。

设置自动执行权限

如果未开启自动执行权限，当智能体需要调用工具时，将在会话中显示“运行”和“跳过所有未运行工具”，需用户手动确认后方可继续。启用自动执行权限后，相关操作将自动通过，无需用户干预。此外，在用户进行手动确认时，还支持设置“每次询问”或“始终允许并开启配置”，以满足不同使用需求。

开启自动执行权限存在操作风险，请在开启前充分评估风险，并在安全可信环境中使用。

您可按照以下步骤设置自动执行权限。

1. 单击码道CodeArts左下角的 ，选择“设置”。
2. 在左侧导航栏中，选择“智能体”。
3. 在“自动批准”下方，根据实际需求启用自动化执行权限，允许智能体在无需人工确认的情况下，直接执行以下操作。

   表2 自动化操作项说明

   自动化操作项	说明
   编辑	允许智能体调用edit、write、deleteFile等工具来编辑您计算机上的文件。

优化输入内容

码道CodeArts通过智能优化用户输入，帮助新手更清晰、专业地提出问题，助力用户一次性获得全面、结构化的高质量回答，有效减少反复追问，提升沟通效率与使用体验。

在输入框中输入相关指令，例如输入内容“帮我生成一个贪吃蛇小游戏”，单击优化输入内容图标 ，等待优化完成。

图4 优化前

图5 优化后

如果优化结果未达到您的预期，可单击撤销优化图标 ，将问题恢复至原始状态。

在会话中添加文件

码道CodeArts支持上传文件，可将其作为对话上下文融入会话。您可以直接上传或拖拽技术文档至聊天输入框中，省去冗长文字描述，即可完整清晰的还原问题场景，实现精准高效的需求沟通。

约束与限制：

本地目录上传文件：单次可上传1至20个附件，不限制附件大小。支持文件格式：.xls，.xlsx，.csv，.doc，.docx，.ppt，.pptx，.pdf，.md，.mdx，.mdc，.txt。

设置方法：

1. 单击输入框中的 。
2. 选择“添加文件 > 本地文件”，浏览并选择本地文件。您也可以直接将本地文件拖入输入框完成上传。
3. 输入提示词，再单击发送图标 ，智能体便会根据提示词创建并执行任务。

在会话中添加图片

码道CodeArts支持上传图片，可将其作为对话上下文融入会话。您可以直接上传或拖拽图片至聊天输入框中，省去冗长文字描述，即可完整清晰的还原问题场景，实现精准高效的需求沟通。

约束与限制：

本地目录上传图片：单张图片大小不超过10MB，全部图片总大小不超过20MB，支持.png、.jpg、.jpeg和.webp格式。

设置方法：

1. 单击输入框中的 。
2. 选择“添加文件 > 上传图片”，浏览并选择本地图片。您也可以直接将本地图片拖入输入框完成上传。
3. 输入提示词，再单击发送图标 ，智能体便会根据提示词创建并执行任务。

使用语音输入

当不便手动输入文字、需要快速口语表达或难以构建结构化指令时，您可以启用语音输入功能。该功能支持单次最长10分钟的连续录音，能够免去冗长的文字描述，帮助您实现精准、高效的需求沟通。

首次使用时，请确保已开启了麦克风访问权限，如果未开启的，需前往系统设置处理（具体操作界面以实际环境为准）。

Windows操作系统：前往开始 > 设置 > 隐私和安全性，开启麦克风访问权限。

1. 设置语音对话语种。
   1. 单击码道CodeArts左下角的 ，选择设置页面。
   2. 在左侧导航栏，选择“外观”。
   3. 设置应用程序的显示语言。

2. 在聊天界面的输入框中，单击语音输入图标 ，开始录入语音，AI会将您的语音输入自动转为文字并填入输入框。

   单次输入的语音时长请不要超过10分钟。

3. 语音输入完成后，单击停止语音输入图标 ，再单击发送图标 ，智能体便会根据提示词自动创建任务。

   如果语音识别结果有误，您可以在发送前进行手动编辑。

管理历史任务

任务创建完成后，在左侧导航栏显示历史任务明细。历史任务是码道CodeArts智能体对过往交互内容的记忆，记录了用户和AI之间的会话过程，包括之前的提问、回答和上下文信息。

添加专家

码道CodeArts面向多样化开发场景内置AI专家角色和专家团，集结各领域资深专家，覆盖问题诊断、方案设计与落地推演，为复杂业务问题提供体系化的专业解答。

详细使用请查看调度领域专家完成任务。

添加技能

技能（Skill）是将编码经验、常见问题解决方案等专业知识组织为可复用模块的能力封装机制，智能体可调用技能，按需动态加载各类“技能包”，提升特定任务的执行能力与效率。

详细使用请查看技能。

添加连接器

智能体可通过连接器对接外部数据源与工具系统，灵活适配多样化业务场景。

详细使用请查看连接器。