openai english to code的进一步展开说明

使用Codex模型和Azure OpenAI服务

2023年7月18日

2名贡献者的反馈

文章导读

Codex模型系列是我们GPT⑶系列的后代，它被训练使用自然语言和数十亿行代码。它在Python中的能力最强，善于于包括C＃，JavaScript，Go，Perl，PHP，Ruby，Swift，TypeScript，SQL和Shell在内的十几种语言。

您可使用Codex履行各种任务，包括：

– 将评论转换为代码
– 在上下文中完成下一行或函数
– 为利用程序查找有用的库或API调用等方式提供知识
– 添加评论
– 优化代码以提高效力

怎样使用Codex模型

以下是一些使用Codex的示例，可以在Azure OpenAI Studio的playground上测试使用Codex系列模型的部署，例如code-davinci-002。

1. 说“你好”（Python）

“`python
“””询问用户的姓名并打印“你好””””
name = input(“请输入你的名字：”)
print(“你好，” + name)
“`

2. 创建随机姓名（Python）

“`python
“””1. 创建一个姓数组 2. 创建一个名字数组 3. 将它们随机组合成一个由100个完全姓名组成的列表”””
import random

first_names = [“John”, “Jane”, “Michael”, “Sarah”]
last_names = [“Smith”, “Johnson”, “Williams”, “Brown”]

full_names = []
for i in range(100):
full_names.append(random.choice(first_names) + ” ” + random.choice(last_names))
“`

3. 创建一个MySQL查询（Python）

“`python
“””表名为customers，列为[CustomerId, FirstName, LastName, Company, Address, City, State, Country, PostalCode, Phone, Fax, Email, SupportRepId] 创建一个MySQL查询，查询所着名为Jane且在得克萨斯州的顾客”””
query = “SELECT * FROM customers WHERE FirstName = ‘Jane’ AND State = ‘Texas’;”
“`

4. 解释代码（JavaScript）

“`javascript
// 函数1
var fullNames = [];
for (var i = 0; i < 50; i++) { fullNames.push(names[Math.floor(Math.random() * names.length)] + " " + lastNames[Math.floor(Math.random() * lastNames.length)]); } // 函数1是用来做什么的？ ``` 最佳实践 您可以在我们的playground中尝试使用Codex模型之一（需要时通过评论提供样式指南）。 要让Codex创建一个有用的补全，最好考虑程序员执行任务所需的信息。这可能只是明确的评论，或者编写一个有用函数所需要的数据，如变量的名称或函数处理的类。 在这个例子中，我们告诉Codex要调用函数的名称以及它将执行的任务。 ```python # 创建一个名为 'nameImporter' 的函数，将名和姓添加到数据库中 ``` 这种方法的扩展性甚至可以根据所提供的评论和数据库架构示例，使Codex撰写不同数据库的有用查询请求。这是一个示例，其中我们为查询提供了列和表名。 ```sql # 表名为albums，列为[AlbumId, Title, ArtistId] # 表名为artists，列为[ArtistId, Name] # 表名为media_types，列为[MediaTypeId, Name] # 表名为playlists，列为[PlaylistId, Name] # 表名为playlist_track，列为[PlaylistId, TrackId] # 表名为tracks，列为[TrackId, Name, AlbumId, MediaTypeId, GenreId, Composer, Milliseconds, Bytes, UnitPrice] # 创建一个查询，查找所有包含超过10首曲目的专辑 ``` 当您向Codex显示数据库架构时，它能够根据已有的信息猜测查询的格式。 指定编程语言 Codex了解许多不同的编程语言。许多语言在注释、函数和其他编程语法上有类似的约定。通过在注释中指定语言和版本，Codex能更好地提供您所需的补全。不过，Codex在样式和语法上相对灵活。以下是R和Python的一个示例。 ```R # R语言 # 计算一组点之间的平均距离 ``` ```python # Python 3 # 计算一组点之间的平均距离 ``` 指定库将帮助Codex理解您的要求 Codex知道许多库、API和模块。通过告诉Codex要使用哪些库，无论是通过注释还是将其导入到代码中，Codex将根据它们提供建议，而不是其他替代品。 ```html

“`

通过指定版本，您可以确保Codex使用最新的库。

请注意，Codex可能会建议有用的库和API，但请务必自行进行研究，以确保它们对您的利用程序是安全的。

对某些语言，注释的风格可以提高输出的质量。例如，在使用Python的情况下，有时使用文档字符串（用三个引号括起来的注释）比使用井号（#）符号给出更高质量的结果。

“`python
“””创建一个用户数组和电子邮件地址数组”””
“`

推荐的编码标准通常建议将函数的描写放在函数内部。使用此格式可以帮助Codex更清楚地理解您希望函数履行的操作。

“`python
def getUserBalance(id):
“””在数据库’UserData’中查找用户并返回他们当前的账户余额”””
“`

为更精确的结果提供示例

如果您有特定的样式或格式需要Codex使用，提供示例或在要求的前部份演示它将有助于Codex更准确地匹配您的需求。

“`python
“””创建一个随机的动物和物种列表”””
animals = [
{“name”: “Chomper”, “species”: “Hamster”},
{“name”: “Charlie”, “species”: “Cat”},
{“name”: “Max”, “species”: “Dog”}
]
“`

较低的温度提供更精确的结果

将API的温度设为0或接近0（例如0.1或0.2）通常在大多数情况下能提供更好的结果。与使用较高温度的GPT⑶模型区别，使用Codex模型时较高的温度可能会致使非常随机或毛病的响应。

在需要Codex提供区别结果的情况下，可以从0开始逐步增加0.1的温度，直到找到适合的变化。

将任务组织成函数

我们可以通过在注释中尽量精确地说明函数的功能来让Codex编写函数。例如，通过编写以下注释，Codex将创建一个JavaScript定时器函数，在用户按下按钮时触发。

“`javascript
// 创建一个定时器，在10秒钟后产生一个警报
“`

创建示例数据

测试利用程序通常需要使用示例数据。由于Codex是一个能理解和编写自然语言的语言模型，因此您可以要求Codex创建类似数组的虚构名称、产品和其他变量的数据。例如，在这里，我们要求Codex创建一个包括天气温度的数组。

“`javascript
/*创建一个包括旧金山的天气温度的数组*/
var weather = [
{ month: ‘January’, high: 58, low: 48 },
{ month: ‘February’, high: 61, low: 50 },
{ month: ‘March’, high: 64, low: 53 },
{ month: ‘April’, high: 67, low: 55 },
{ month: ‘May’, high: 70, low: 58 },
{ month: ‘June’, high: 73, low: 61 },
{ month: ‘July’, high: 76, low: 63 },
{ month: ‘August’, high: 77, low: 64 },
{ month: ‘September’, high: 76, low: 63 },
{ month: ‘October’, high: 73, low: 61 },
{ month: ‘November’, high: 68, low: 57 },
{ month: ‘December’, high: 64, low: 54 }
];
“`

复合函数和小型利用程序

我们可以向Codex提供一个注释，其中包括一个复杂要求，如创建一个随机姓名生成器或使用用户输入履行任务，Codex可以根据标记数生成其余的代码。

“`javascript
/*创建一个动物列表
创建一个城市列表
使用列表在每一个城市的动物园中生成故事 */
“`

限制生成结果的长度以取得更精确的结果或更低的延迟

在Codex中要求较长的结果可能致使不准确的答案和重复。通过减少max_tokens的大小和设置停止标记，限制查询的长度。例如，添加” ”作为停止序列，将生成的代码限制为一行。较小的生成结果也会减少延迟。

使用流式传输来减少延迟

大型的Codex查询可能需要几十秒才能完成。要构建需要更低延迟的利用程序（例如履行自动补全的编码助手），可以斟酌使用流式传输。在模型生成全部完成之前，响应将被返回。只需要部份完成的利用程序可以通进程序化地或使用stop的创造性值来切断完成，从而减少延迟。

用户可以将流式传输与复制结合使用，通过从API要求多个解决方案，并使用第一个返回的响应来减少延迟。通过设置n>1来实现。这类方法消耗更多的令牌配额，因此请谨慎使用（例如，通过max_tokens和stop设置公道的值）。

使用Codex解释代码

Codex创建和理解代码的能力使我们能够使用它履行诸如解释文件中的代码是做甚么的一类任务。实现这一点的一种方式是在函数后面放置一个以“This function”或“This application is”开头的注释。Codex通常会将其解释为开始说明的部份，并完成后续文本。

“`javascript
/*解释前一个函数的功能：它
“`

解释SQL查询

在此示例中，我们使用Codex以人们可浏览的格式解释一个SQL查询的功能。

“`sql
SELECT DISTINCT department.name FROM department JOIN employee ON department.id = employee.department_id JOIN salary_payments ON employee.id = salary_payments.employee_id WHERE salary_payments.date BETWEEN ‘2023-06-01’ AND ‘2023-06⑶0’ GROUP BY department.name HAVING COUNT(employee.id) > 10; –说明上述查询的人类可读格式–
“`

编写单元测试

通过添加“Unit test”和一个开始函数的注释，可以简单地在Python中创建一个单元测试。

“`python
# Python 3
def sum_numbers(a, b):
return a + b

# Unit test
def test_sum_numbers():
assert sum_numbers(2, 3) == 5
assert sum_numbers(⑴, 1) == 0
assert sum_numbers(0, 0) == 0
“`

检查代码毛病

通过使用示例，您可以向Codex展现如何辨认代码中的毛病。在某些情况下，不需要示例，但演示提供描写的级别和详细程度可以帮助Codex理解要查找和解释的内容。 （Codex检查毛病的目的是辅助用户，但不能替换用户的仔细检查 ）

“`javascript
/*解释为何前一个函数不起作用*/
“`

使用源数据编写数据库函数

就像一个人类程序员从了解数据库结构和列名中受益一样，Codex可以利用这些数据来帮助您编写准确的查询要求。在这个例子中，我们插入了一个数据库的模式，并告知Codex查询数据库的内容。

“`sql
# 表名为albums，列为[AlbumId, Title, ArtistId]
# 表名为artists，列为[ArtistId, Name]
# 表名为media_types，列为[MediaTypeId, Name]
# 表名为playlists，列为[PlaylistId, Name]
# 表名为playlist_track，列为[PlaylistId, TrackId]
# 表名为tracks，列为[TrackId, Name, AlbumId, MediaTypeId, GenreId, Composer, Milliseconds, Bytes, UnitPrice]
# 创建一个查询，查找所有包括超过10首曲目的专辑
“`

语言转换

您可以通过遵守简单的格式，列出要转换的代码的语言，并在注释中提供目标语言来让Codex将代码从一种语言转换为另外一种语言。

“`python
# 将此从Python转换为R
# Python版本[Python代码]
# 结束
# R版本
“`

为库或框架重写代码

如果您希望Codex使函数更高效，可以向其提供要重写的代码，然后唆使怎样使用哪一种格式。

“`javascript
// 将此重写为一个React组件
var input = document.createElement(‘input’);
input.setAttribute(‘type’, ‘text’);
document.body.appendChild(input);

var button = document.createElement(‘button’);
button.innerHTML = ‘Say Hello’;
document.body.appendChild(button);

button.onclick = function() {
var name = input.value;
var hello = document.createElement(‘div’);
hello.innerHTML = ‘Hello ‘ + name;
document.body.appendChild(hello);
};
// React版本：
“`

下一步

了解更多关于支持Azure OpenAI的基本模型的信息。

【进一步展开说明】

本文介绍了Codex模型和Azure OpenAI服务的使用。Codex是一个基于GPT⑶的模型系列，它不但经过自然语言的训练，还经过了数十亿行代码的训练。它善于Python，并熟练掌握包括C＃、JavaScript、Go、Perl、PHP、Ruby、Swift、TypeScript、SQL和Shell在内的十几种编程语言。

使用Codex可以完成多种任务，包括将评论转换为代码、在上下文中完成下一行或函数、查找有用的库或API调用等。本文提供了一些使用Codex模型的示例，其中包括使用Python和JavaScript编写的代码段。另外，文章还分享了使用Codex的最好实践，包括指定编程语言、指定库和提供示例等。

为了取得更准确的结果，文章建议设置较低的温度，并限制代码完成的长度。另外，通过将任务组织成函数、使用源数据编写数据库函数并将Codex用于解释代码等，可以更有效地使用Codex模型。

总的来讲，Codex模型和Azure OpenAI服务为开发人员提供了强大的工具，可以提高编程效力和开发速度。通过了解和利用本文介绍的使用技能和最好实践，开发人员可以更好地利用这些工具来提升工作效果。

openai english to code的常见问答Q&A