在 Vertex AI Studio 中，您可以设计和迭代问题，并比较不同配置和模型的结果。完成问题设计后，您可以将问题部署为 Web 应用，以便与协作者或目标用户共享，让他们测试 Web 应用。Web 应用托管在 Cloud Run 上，可在 Google Cloud 控制台之外使用。
在本快速入门中，您将执行以下操作：
- 使用提示变量创建提示
- 将提示部署为 Web 应用
- 监控部署进度并测试已部署的应用
- 更新并重新部署您的提示
- 测试多模态支持功能的提示提交
前期准备
如果您之前从未使用过 Vertex AI Studio，可以按照另一个快速入门指南操作，或参加 Google Cloud Skills Boost 课程，了解 Vertex AI Studio 的基础知识。在本指南中，您需要具备以下条件：
- 创建了一个启用了结算功能的 Google Cloud 项目
- 已启用 Vertex AI API
需要其他权限
除了使用 Vertex AI Studio 的现有权限之外，您还需要拥有以下权限才能部署提示：
| 操作 | 所需权限 | 用途 |
|---|---|---|
| 启用其他 API | serviceusage.services.enable |
启用以下 API：
|
| 授予服务账号权限 | resourcemanager.projects.setIamPolicy |
向
Compute Engine 默认服务账号授予以下角色：
|
| 部署特定权限 |
|
在部署过程中，系统会将一组源代码上传到 Cloud Storage，然后将其部署到 Cloud Run 并创建一项新服务。必须使用 artifactregistry.repositories.create
为容器映像创建代码库。必须使用 run.services.setIamPolicy 才能使服务可公开访问。 |
如果您是项目的所有者，则无需执行其他操作，只需按照 Vertex AI Studio 中的指南操作即可。如果您不是项目所有者，请让项目管理员执行前两个操作，然后为您授予 Editor (roles/editor) 和 Cloud Run Admin (roles/run.admin) 角色。
使用提示变量创建提示
前往 Vertex AI Studio 的创建提示页面，然后点击提示输入框中的 Add variable（添加变量）。
在管理提示变量对话框中，输入变量名称并为其指定值。然后点击应用。
在提示输入框中，使用变量组合提示，然后调整其他参数。例如，您可以启用“通过 Google 搜索获取实时天气信息”，并将“始终从网络获取当前天气信息”作为系统说明。
将提示部署为 Web 应用
如需将问题作为 Web 应用部署，请点击右上角的使用代码构建按钮。然后点击以应用形式部署。
保存提示
系统会弹出“保存提示”对话框，因为您需要先保存提示，然后才能部署提示。保存提示后，系统会自动打开部署对话框。
为首次部署启用 API 并授予权限
保存提示后，部署流程将继续。如果这是您首次进行部署，您会看到用于启用所需 API 的对话框。点击启用所需的 API。
启用 API 后，系统会显示创建 Web 应用对话框。作为公开预览版功能，不支持访问权限控制。因此，所有已部署的应用都将允许公开访问。请勿在问题中包含敏感信息或个人身份信息 (PII)。
选中我了解此应用将公开部署复选框，然后点击创建应用。
如果这是您首次部署，系统会弹出另一个对话框，要求您向服务账号授予所需角色。点击全部授予以继续。
部署开始
Vertex AI Studio 将创建一个包含 Web 应用源代码的 zip 文件，并将该 zip 文件上传到 Cloud Storage 存储桶。部署开始后，系统会弹出管理 Web 应用对话框，其中包含与部署相关的信息，例如应用的名称、上次部署的时间、部署状态等。
监控部署状态
部署需要 2-3 分钟才能完成，部署状态会显示在管理 Web 应用对话框的状态列中。如果您关闭了管理 Web 应用对话框，可以从使用代码构建按钮下的菜单中重新打开该对话框。
部署完成后，状态列将更改为准备就绪，应用名称旁边会显示打开按钮。
访问控制和 Secret 密钥
默认情况下，您的 Web 应用在部署时启用了允许未经身份验证的用户访问访问权限控制。您可以点击 铅笔图标按钮将其关闭。如需了解详情，请参阅“关闭公开访问”部分。
为了提供基本保护，Web 应用需要将 Secret 密钥附加到用于提交提示的网址。您可以在 Secret Key 列中找到密钥。如果您从 Vertex AI Studio 打开 Web 应用，系统会将密钥附加到网址。
打开 Web 应用并提交问题
点击管理 Web 应用对话框中的打开，即可访问已部署的应用。应用应以 ?key=SECRET_KEY 格式附加到网址的密钥打开。
为该变量输入值，然后点击提交。您应该可以在右侧看到结果。
从“使用代码构建”按钮菜单中打开 Web 应用
如果您的 Web 应用已准备就绪，您也可以从使用代码构建按钮菜单中打开它。
Cloud Run 是一项无服务器服务，这意味着，如果应用的容器未被积极使用，系统会将其关闭。因此，Web 应用有时可能需要几秒钟才能加载完毕，或者如果您让 Web 应用空闲太久，提交操作将无法执行。刷新页面应该可以解决此问题。
通过通知铃监控状态
您还可以点击铃铛图标，从通知菜单中监控状态。如果部署成功完成，铃铛图标将停止加载动画并显示一个绿色圆圈。
如果您点击该通知，系统会将您重定向到 Cloud Run 页面。Cloud Run 页面中的网址未附加密钥。您需要手动以 ?key=SECRET_KEY 格式附加该值。
更新并重新部署您的提示
您可以在 Vertex AI Studio 中进一步修改提示，并将提示转换为对话。然后，点击使用代码构建按钮，再点击管理应用以打开管理 Web 应用对话框。点击更新应用，使用更新后的提示重新部署 Web 应用。
系统会显示一个确认对话框。该消息表示，如果您重新部署，您对部署的 Web 应用在 Vertex AI Studio 之外（例如在 Cloud Run 源代码编辑器中）所做的任何更改都会丢失。点击确认以继续。
系统会再次弹出管理 Web 应用对话框。该过程与初始部署类似。您可以按照与首次部署相同的方式监控进度。
更新完成后，您可以重新打开 Web 应用。您会看到包含提示变量的对话界面。填写值，然后输入任何非空内容以继续对话。
插入多模态内容
您可以将图片、视频、音频和文档等输入内容插入到对话界面中。支持的输入取决于为问题选择的模型。请参阅有关每种模型的多模式支持的文档。
如需插入文件，请点击对话输入框中的 剪贴图标按钮。
您将能够使用您提供的输入与模型互动。
高级主题
熟悉部署流程后，您可以考虑执行以下操作。
在 Cloud Run 中修改源代码
如果您想自定义 Web 应用，可以更改 Cloud Run 中的源代码。点击行末的 “更多”图标按钮，在管理 Web 应用对话框中打开 Cloud Run 源代码页面。
或者，您也可以点击源代码编辑器链接，从 Web 应用转到安全页面。
在 Cloud Run 源代码页面中，点击修改源代码以进入修改模式。完成后，点击保存并重新部署。
重新部署完成后，您需要从 Vertex AI Studio 打开应用。您可以通过 Deployed from Vertex AI 徽章中的链接前往 Vertex AI Studio 页面。
关闭公开访问权限
如果您不需要 Web 应用可供公众访问，可以在 Cloud Run 中将其关闭。打开管理 Web 应用对话框，然后点击访问控制列中的 铅笔图标。Cloud Run 安全页面将在新标签页中打开。
您还可以通过点击安全设置链接，从 Web 应用前往安全页面。
在 Web 应用对应的 Cloud Run 服务的“安全”页面中，选中使用 Cloud IAM 对传入请求进行身份验证，然后选择要求进行身份验证。 点击保存。
这会导致您的 Web 应用无法再通过该网址访问。如果您尝试访问该页面，则会看到错误：禁止访问页面。
重新开启公开访问权限
如果您想恢复公开访问权限，请清除使用 Cloud IAM 对传入请求进行身份验证复选框，然后保存。 如果您选择允许未经身份验证的调用，则当您的项目位于组织中时，该设置将不起作用。 如需了解详情，请参阅 Cloud Run 中的身份验证。
设置本地访问权限以进行开发
公开预览版尚不支持访问权限控制。因此，关闭公开访问权限后，您只能通过设置本地代理来访问 Web 应用。您可以通过 gcloud 命令执行此操作。首先，通过 Google Cloud 控制台右上角的 终端图标按钮打开 Cloud Shell。 系统会要求您为 Cloud Shell 授权。点击授权以继续。
完成后，打开管理 Web 应用对话框，然后点击行末的 更多图标按钮，查看更多操作。点击通过 Cloud Shell 设置本地访问权限。
系统会向 Cloud Shell 中添加一条命令。按 Enter 键，然后等待打印完成。点击以 Click on the
link to preview 开头的行中的链接。您将能够查看自己的申请。此链接仅在您运行 gcloud 命令时才有效。
常见问题
身份验证错误：无密钥
如果您看到以下错误，则表示未将任何密钥附加到网址。按照从 Vertex AI Studio 中打开 Web 应用的说明操作，或从管理应用对话框中复制密钥，并将其以 ?key=SECRET_KEY 格式附加到网址。
身份验证错误：密钥无效
以下错误表示附加到网址的密钥无效。 每个提示的密钥都是唯一的。如果您有其他提示中显示的密钥，则该密钥将无法使用。按照说明正确打开 Web 应用。
400 参数无效：输入为空
如果您在提示变量中输入了内容，但聊天内容为空，则会出现以下错误；系统会显示 400 错误消息。您可以通过输入任何非空内容并重新提交来解决此问题。
400 参数无效：不支持 mimeType
如果您选择的文件类型不受模型支持，则模型会返回 400 错误。这是正常现象，您必须使用模型支持的其他类型的文件。如需了解每个模型对多模态支持的详情，请参阅 文档。
后续步骤
如需了解 Vertex AI Studio 的更多功能，请参阅文档或 Google Cloud Skills Boost 的 Vertex AI Studio 简介课程。
查看 Cloud Run 的价格。
请参阅 Cloud Run 中的身份验证。