跳过主要内容

​
概览

  • AWS Bedrock： 一项完全托管的服务，通过 AWS 提供对领先生成式 AI 模型（例如 Anthropic Claude、Amazon Nova）的访问。
    了解有关 AWS Bedrock 的更多信息.
  • Cline： 一款 VS Code 扩展程序，通过与 AI 模型集成充当编码助手，使开发者能够生成代码、调试和分析数据。
  • 开发者重点： 本指南专为希望通过使用 API 密钥的简化设置，通过 AWS Bedrock 访问前沿模型的个人开发者量身定制。

​
步骤 1：准备您的 AWS 环境

​
1.1 个人用户设置 - 创建 Bedrock API 密钥

有关更详细的说明，请查看文档。
  1. 登录 AWS 管理控制台
    AWS 控制台
  2. 访问 Bedrock 控制台

​
1.2 创建或修改策略

为了确保 Cline 可以与 AWS Bedrock 交互，您的 IAM 用户或角色需要特定的权限。尽管 AmazonBedrockLimitedAccess 托管策略提供了全面的访问权限，但为了实现更受限且安全的设置，遵循最小特权原则，以下最小权限足以满足 Cline 的核心模型调用功能
  • bedrock:InvokeModel
  • bedrock:InvokeModelWithResponseStream
  • bedrock:CallWithBearerToken
您可以创建包含这些权限的自定义 IAM 策略，并将其附加到您的 IAM 用户或角色。
  1. 在 AWS IAM 控制台中，创建新策略。
  2. 使用 JSON 编辑器添加以下策略文档 
    {
	"Version": "2012-10-17",
	"Statement": [
		{
			"Effect": "Allow",
			"Action": ["bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream", "bedrock:CallWithBearerToken"],
			"Resource": "*" // For enhanced security, scope this to specific model ARNs if possible.
		}
	]
}
  3. 命名该策略（例如，ClineBedrockInvokeAccess）并将其附加到与您创建的密钥关联的 IAM 用户。IAM 用户和 API 密钥具有相同的前缀。
重要注意事项
  • Cline 中的模型列表： 最小权限（bedrock:InvokeModel、bedrock:InvokeModelWithResponseStream）足以让 Cline 使用模型，如果您在 Cline 的设置中直接指定模型 ID。如果您依赖 Cline 动态列出可用的 Bedrock 模型，您可能需要额外的权限，例如 bedrock:ListFoundationModels。
  • AWS Marketplace 订阅： 对于第三方模型（例如 Anthropic Claude），AmazonBedrockLimitedAccess 策略授予您通过 AWS Marketplace 订阅所需的权限。无需启用显式访问权限。对于 Anthropic 模型，您仍然需要通过控制台提交首次使用 (FTU) 表格。如果您在 Cline 聊天中收到以下消息 [ERROR] Failed to process response: Model use case details have not been submitted for this account. Fill out the Anthropic use case details form before using the model.，请打开 AWS Bedrock 控制台中的 Playground，选择任何 Anthropic 模型并填写表格（您可能需要先发送一个提示）。

​
第 2 步：验证区域和模型访问权限

​
2.1 选择并确认区域

  1. 选择一个区域
    AWS Bedrock 在多个区域（例如美国东部、欧洲、亚太地区）可用。选择符合您的延迟和合规性需求的区域。
    AWS 全球基础设施
  2. 验证模型访问权限
    • 注意： 某些模型只能通过推理配置文件访问。在这种情况下，请勾选“跨区域推理”复选框。

​
第 3 步：配置 Cline VS Code 扩展

​
3.1 安装并打开 Cline

  1. 安装 VS Code
    从 VS Code 网站下载。
  2. 安装 Cline 扩展
    • 打开 VS Code。
    • 转到扩展市场 (Ctrl+Shift+X 或 Cmd+Shift+X)。
    • 搜索 Cline 并安装它。

​
3.2 配置 Cline 设置

  1. 打开 Cline 设置
    • 点击设置 ⚙️ 选择您的 API 提供商。
  2. 选择 AWS Bedrock 作为 API 提供商
    • 从 API 提供商下拉列表中，选择 AWS Bedrock。
  3. 输入您的 AWS API 密钥
    • 输入您的 API 密钥
    • 指定正确的 AWS 区域（例如，us-east-1 或您企业批准的区域）。
  4. 选择一个模型
    • 选择一个按需模型（例如，anthropic.claude-3-5-sonnet-20241022-v2:0）。
  5. 保存并测试
    • 点击 完成/保存 以应用您的设置。
    • 通过发送一个简单的提示（例如，“生成一个 Python 函数来检查一个数字是否为素数。”）来测试集成。

​
步骤 4：安全、监控和最佳实践

  1. 安全访问
  2. 增强网络安全
  3. 监控和记录活动
    • 启用 AWS CloudTrail 以记录 Bedrock API 调用。
    • 使用 CloudWatch 监控指标，例如调用次数、延迟和令牌使用情况。
    • 设置异常活动警报。
  4. 处理错误和管理成本
    • 为限流错误实施指数退避。
    • 使用 AWS Cost Explorer 并设置账单警报以跟踪使用情况。
      AWS 成本管理
  5. 定期审计和合规性
    • 定期审查 IAM 角色和 CloudTrail 日志。
    • 遵循内部数据隐私和治理政策。

​
结论

通过遵循这些步骤，您可以快速将 AWS Bedrock 与 Cline VS Code 扩展集成，从而加快开发速度
  1. 准备您的 AWS 环境： 创建具有必要权限的 Bedrock API 密钥。
  2. 验证区域和模型访问权限： 确认您选择的区域支持您需要的模型。
  3. 配置 VS Code 中的 Cline： 安装 Cline 并使用您的 AWS API 密钥进行设置，然后选择合适的模型。
  4. 实施安全和监控： 使用 IAM、网络安全、监控和成本管理的最佳实践。
有关更多详细信息，请查阅 AWS Bedrock 文档。祝您编码愉快！
本指南将随着 AWS Bedrock 和 Cline 的发展而更新。请始终参考最新的文档和内部政策以获取最新实践。