教程

从注释生成代码

使用文学编程让 Bob 从自然语言注释生成代码,Bob 帮助您直接在编辑器中编写精确的、上下文感知的代码修改。

文学编程允许您直接在编辑器中借助 AI 辅助编写代码。无需切换到聊天窗口或编写冗长的提示,您只需在代码应该出现的位置用简单的语言编写指令。然后 Bob 会在上下文中为您生成实现,并显示更改的差异。

文学编程对以下修改有效:

  • 添加包装逻辑: 在现有代码周围添加重试机制、错误处理或日志记录
  • 重构特定块: 修改特定部分同时保留周围的逻辑
  • 快速、有针对性的修改: 对特定函数进行精确更改而不影响更广泛的结构。对于影响多个函数或文件的复杂修改,请考虑使用代理聊天侧边栏创建计划

在本教程中,您通过用重试逻辑包装代码块来修复间歇性超时。

先决条件

要完成本教程,您需要以下内容:

  • 如果您还没有,请克隆 Galaxium Travels 演示代码。克隆命令还会检出包含您在教程中使用的代码的 bob-learning-path-branch 分支。
git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels
  • 打开 Galaxium Travels 演示代码的 Bob IDE
  • 您已在 Bob 的代理聊天界面中运行 /init 以初始化 Bob 并允许其从代码库收集上下文。如果您还未执行此操作,请参阅开始项目教程
  • 虽然不是必需的,但请考虑完成快速入门教程以熟悉 Bob 的界面和功能。
  • 您可能需要为本教程启动新的上下文窗口。请参阅创建新上下文窗口教程

使用文学编程

Galaxium Travels 后端不可靠,偶尔会出现超时错误。您可以使用文学编程用重试逻辑包装特定的代码块,而不是从头重写代码。

打开文件

打开 booking_system_frontend/src/pages/Flights.tsx 文件。

定位光标

点击第 43 行。

激活文学编程模式

点击省略号,然后选择 Literate Coding Mode

选择文学编程模式

编写指令

输入以下自然语言指令来描述第 43 行所需的更改:

后端有时不可靠。我们这里需要重试逻辑

在文学编程模式中输入的自然语言提示

生成代码

点击 Generate 生成修改。

Bob 在差异视图界面中呈现更改。红色突出显示的文本显示删除了哪些代码,绿色突出显示的文本显示 Bob 添加了哪些代码。

Bob 在差异视图中呈现建议的更改

接受更改

查看更改并点击 Accept All 应用它们。

您已添加重试循环来解决 Galaxium Travels Web 应用程序中的超时错误。

后续步骤

在本教程中,您学习了文学编程如何让您使用自然语言驱动的精确代码修改。文学代码会显示代码差异,以便您在接受更改之前可以查看代码。

继续学习规划和实现复杂功能,了解代理聊天侧边栏,它是 Bob 中复杂多步骤开发任务的主要界面。

这个主题怎么样?