Codey for Code Chat (codechat-bison) 是支持代码聊天的模型的名称。它是一个基础模型，可支持专用于代码的多轮对话。该模型允许开发者与聊天机器人聊天，以解答与代码相关的问题。code chat API 用于与 Codey for Code Chat 模型交互。
Codey for Code Chat 非常适合通过来回交互完成的代码任务，以便您可以参与连续对话。对于需要单次交互的代码任务，请使用用于代码补全的 API 或用于代码生成的 API。
如需在控制台中探索此模型，请参阅 Model Garden 中的 Codey for Code Chat 模型卡片。
前往 Model Garden
使用场景
代码聊天的一些常见应用场景包括：
获取有关代码的帮助：获取有关代码问题的帮助，例如有关 API 的问题、支持的编程语言的语法或您编写的代码需要哪个版本的库。
调试：获取有关无法编译或包含错误的代码的帮助。
记录：获取有关理解代码的帮助，以便您可以准确记录代码。
了解代码：获取有关您不熟悉的代码的帮助。
HTTP 请求
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/codechat-bison:predict
模型版本
如需使用最新的模型版本，请指定不含版本号的模型名称，例如 codechat-bison。
如需使用稳定的模型版本，请指定模型版本号，例如 codechat-bison@002。每个稳定版本会在后续稳定版发布日期后的六个月内可用。
下表包含可用的稳定模型版本：
| codechat-bison 模型 | 发布日期 | 终止日期 |
|---|---|---|
| codechat-bison@002 | 2023 年 12 月 6 日 | 2025 年 4 月 9 日 |
如需了解详情，请参阅模型版本和生命周期。
请求正文
{
"instances": [
{
"context": string,
"messages": [
{
"content": string,
"author": string
}
]
}
],
"parameters":{
"temperature": number,
"maxOutputTokens": integer,
"candidateCount": integer,
"logprobs": integer,
"presencePenalty": float,
"frequencyPenalty": float,
"seed": integer
}
}
以下是代码聊天模型 codechat-bison 的参数。codechat-bison 模型是 Codey 中的模型之一。您可以使用这些参数来帮助优化有关代码的聊天机器人对话的提示。如需了解详情，请参阅代码模型概览和创建有关代码的聊天提示。
| 参数 | 说明 | 可接受的值 |
|---|---|---|
|
|
应该先将文本提供给模型以打下响应的基础。 | 文本 |
|
（必填） |
以结构化的备用作者形式提供给模型的对话历史记录。消息按时间顺序显示：最旧的消息在前面，最新的信息在后面。当消息的历史记录导致输入超过最大长度时，最旧的消息会被移除，直到整个提示在允许的限制范围内。 |
List[Structured Message]
"author": "user",
"content": "user message" |
|
（可选） |
温度 (temperature) 在生成回复期间用于采样。温度可以控制词元选择的随机性。较低的温度有利于需要更少开放性或创造性回复的提示，而较高的温度可以带来更具多样性或创造性的结果。温度为 0 表示始终选择概率最高的词元。在这种情况下，给定提示的回复大多是确定的，但可能仍然有少量变化。 |
|
|
（可选） |
回复中可生成的词元数量上限。词元约为 4 个字符。100 个词元对应大约 60-80 个单词。
指定较低的值可获得较短的回复，指定较高的值可获得可能较长的回复。 |
|
|
（可选） |
要返回的响应变体数量。 对于每个请求，您需要为所有候选词元的输出词元付费，但只需为输入词元支付一次费用。 指定多个候选项是适用于
|
|
|
（可选） |
返回每个生成步骤中排名靠前的候选 token 的对数概率。系统会始终在每个步骤返回模型的所选 token 及其对数概率，这些 token 可能不会显示在最可能候选项列表中。使用介于 1 到 5 范围内的整数值指定要返回的候选项数量。 |
|
|
（可选） |
正值会惩罚生成的文本中反复出现的词元，从而降低重复内容概率。可接受的值为 -2.0-2.0。 |
|
|
（可选） |
正值会惩罚已生成文本中已存在的词元，从而增加生成更多样化内容的概率。可接受的值为 -2.0-2.0。 |
|
|
当种子固定为特定值时，模型会尽最大努力为重复请求提供相同的回答。无法保证确定性输出。此外，更改模型或参数设置（例如温度）可能会导致回答发生变化，即使您使用相同的种子值也是如此。默认情况下，系统会使用随机种子值。
这是预览版功能。 |
|
示例请求
REST
如需使用 Vertex AI API 测试文本提示，请向发布方模型端点发送 POST 请求。
在使用任何请求数据之前，请先进行以下替换：
- PROJECT_ID：您的项目 ID。 如需了解其他字段，请查看请求正文表。
HTTP 方法和网址：
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/codechat-bison:predict
请求 JSON 正文：
{
"instances": [
{
"messages": [
{
"author": "AUTHOR",
"content": "CONTENT"
}
]
}
],
"parameters": {
"temperature": TEMPERATURE,
"maxOutputTokens": MAX_OUTPUT_TOKENS,
"candidateCount": CANDIDATE_COUNT
}
}
如需发送请求，请选择以下方式之一：
curl
将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/codechat-bison:predict"
PowerShell
将请求正文保存在名为 request.json 的文件中，然后执行以下命令：
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/codechat-bison:predict" | Select-Object -Expand Content
您应该会收到类似示例响应的 JSON 响应。
Python
如需了解如何安装或更新 Vertex AI SDK for Python，请参阅安装 Vertex AI SDK for Python。 如需了解详情，请参阅 Python API 参考文档。
Node.js
在尝试此示例之前，请按照《Vertex AI 快速入门：使用客户端库》中的 Node.js 设置说明执行操作。 如需了解详情，请参阅 Vertex AI Node.js API 参考文档。
如需向 Vertex AI 进行身份验证，请设置应用默认凭据。 如需了解详情，请参阅为本地开发环境设置身份验证。
Java
在尝试此示例之前，请按照《Vertex AI 快速入门：使用客户端库》中的 Java 设置说明执行操作。 如需了解详情，请参阅 Vertex AI Java API 参考文档。
如需向 Vertex AI 进行身份验证，请设置应用默认凭据。 如需了解详情，请参阅为本地开发环境设置身份验证。
响应正文
{
"predictions": [
{
"candidates": [
{
"author": string,
"content": string
}
],
"citationMetadata": {
"citations": [
{
"startIndex": integer,
"endIndex": integer,
"url": string,
"title": string,
"license": string,
"publicationDate": string
}
]
},
"logprobs": {
"tokenLogProbs": [ float ],
"tokens": [ string ],
"topLogProbs": [ { map<string, float> } ]
},
"safetyAttributes":{
"categories": [ string ],
"blocked": false,
"scores": [ float ]
},
"score": float
}
]
}
| 响应元素 | 说明 |
|---|---|
author |
指示聊天响应作者的 string。 |
blocked |
与安全属性关联的 boolean 标志，用于指示模型的输入或输出是否被阻止。如果 blocked 为 true，则响应中的 errors 字段包含一个或多个错误代码。如果 blocked 为 false，则响应不包含 errors 字段。
|
categories |
与所生成内容关联的安全属性类别名称的列表。scores 参数中的得分顺序与类别的顺序匹配。例如，scores 参数中的第一个得分表示响应违反 categories 列表中第一个类别的可能性。 |
content |
聊天响应的内容。 |
endIndex |
一个整数，用于指定引用在 content 中的结束位置。
|
errors |
错误代码数组。仅当响应中的 blocked 字段为 true 时，响应中才会包含 errors 响应字段。如需了解如何理解错误代码，请参阅安全错误。
|
license |
与引用关联的许可。 |
publicationDate |
引用的发布日期。其有效格式为 YYYY、YYYY-MM、YYYY-MM-DD。 |
safetyAttributes |
一个安全属性阵列。该阵列包含每个响应候选项的一个安全属性。 |
score |
小于零的 float 值。score 的值越高，模型回复的置信度就越高。
|
scores |
float 值的数组。每个值都是一个得分，用于指示回复违反检查所依据的安全类别的可能性。
值越小，模型就认为回复越安全。数组中得分的顺序与 categories 回复元素中的安全属性的顺序对应。
|
startIndex |
一个整数，用于指定引用在 content 中的起始位置。
|
title |
引用来源的标题。来源标题的示例可能是新闻报道或书籍标题。 |
url |
引用来源的网址。网址来源的示例可能是新闻网站或 GitHub 代码库。 |
tokens |
采样词元。 |
tokenLogProbs |
采样词元的对数概率。 |
topLogProbs |
每个步骤中最可能的候选词元及其对数概率。 |
logprobs |
“logprobs”参数的结果。1-1 映射到“候选”。 |
示例响应
{
"predictions": [
{
"citationMetadata": [
{
"citations": []
}
],
"candidates": [
{
"author": "AUTHOR",
"content": "RESPONSE"
}
],
"safetyAttributes": {
"categories": [],
"blocked": false,
"scores": []
},
"score": -1.1161688566207886
}
]
}
流式传输来自生成式 AI 模型的响应
对于 API 的流式传输请求和非流式传输请求，这些参数是相同的。
如需使用 REST API 查看示例代码请求和响应，请参阅使用流式传输 REST API 的示例。
如需使用 Python 版 Vertex AI SDK 查看示例代码请求和响应，请参阅使用 Python 版 Vertex AI SDK 进行流式传输的示例。