必应 Copilot 开源 API 的调用指南

引言

必应 Copilot 是微软开发的一个大型语言模型，旨在使用户与搜索引擎进行自然的对话式交互。它提供了强大的文本生成、翻译、摘要和问答功能。微软最近开源了 Bing Copilot API，使开发者能够将其集成到自己的应用程序中。本文将提供一个全面的指南，介绍如何调用 必应 Copilot 开源 API。

API 端点

必应 Copilot API 通过以下端点提供：


https://copilot.azure.ai/<version>/models/<model-id>


其中：

• <version> 是 API 的版本号，目前为 preview-1。
• <model-id> 是要使用的模型的标识符。支持以下模型：
  • text-bison-001：用于文本生成和翻译。
  • text-bison-002：用于文本摘要和问答。

HTTP 请求

要调用 API，需要使用 HTTP POST 请求。请求 body 应包含以下 JSON 数据：

json
{
"inputs": [
{
"text": "输入文本"
}
]
}


其中：

• inputs 是一个包含输入文本的数组。对于文本生成和翻译，输入文本应为要生成的文本或要翻译的文本。对于文本摘要和问答，输入文本应为要摘要或回答的文本。

请求头

HTTP 请求应包含以下请求头：

• Content-Type: application/json
• Ocp-Apim-Subscription-Key: 必应 Copilot 订阅密钥

响应

如果请求成功，API 将返回一个 JSON 响应。响应 body 将包含以下数据：

json
{
"candidates": [
{
"output": "响应文本",
"score": 0.5 // 可选，表示输出文本的置信度
}
]
}


其中：

• candidates 是一个包含候选响应的数组。对于文本生成和翻译，候选响应将是生成的文本或翻译后的文本。对于文本摘要和问答，候选响应将是摘要或答案。
• output 是候选响应的文本。
• score 是候选响应的置信度（可选），介于 0 到 1 之间。

代码示例

以下是一个使用 Python 调用 必应 Copilot API 的代码示例：

“`python
import requests
import json

subscriptionkey = “YOURSUBSCRIPTIONKEY”
modelid = “text-bison-002”

创建输入数据

input_data = json.dumps({“inputs”: [{“text”: “What is the capital of France?”}]})

创建请求头

headers = {“Content-Type”: “application/json”, “Ocp-Apim-Subscription-Key”: subscription_key}

发送请求

response = requests.post(f”https://copilot.azure.ai/preview-1/models/{modelid}”, data=inputdata, headers=headers)

解析响应

responsedata = response.json()
print(responsedata[“candidates”][0][“output”])
“`

最佳实践

调用 必应 Copilot API 时，请遵循以下最佳实践：

• 使用特定的模型 ID。例如，对于文本摘要和问答，使用 text-bison-002 模型。
• 提供清晰且简洁的输入文本。
• 考虑响应的置信度评分。置信度较高的响应更有可能是准确的。
• 将 Copilot 的响应与其他信息来源进行交叉参考，以提高准确性。

问答

Q1：必应 Copilot API 的主要功能是什么？
A1：文本生成、翻译、摘要和问答。

Q2：如何获得必应 Copilot 订阅密钥？
A2：通过 Azure 认知服务门户。

Q3：必应 Copilot API 是否免费使用？
A3：否，它需要付费订阅。

Q4：哪个模型最适合文本摘要和问答？
A4：text-bison-002。

Q5：如何提高必应 Copilot 响应的准确性？
A5：交叉参考来自多个来源的响应并考虑置信度评分。