跳到主要内容

操作演练

本页从头到尾演练一个演示工作流:从代理技能生成它、发布它、运行它、批准它发起的请求,再确认结果,全程无需退出登录。您以 root 身份登录,并通过代理登录依次以各个演示账户的身份操作,因此整个过程在一个浏览器标签页中就能完成。

请在这里选择提供商。本页所有与提供商相关的内容都会随之切换。

您将通过 Demo AWS EC2 Launch 技能启动一个 EC2 实例。

开始之前​

  • 后端正在运行,并且已启用演示数据。
  • 您知道 root 的密码:ROOT_PASSWORD 的值,如果未设置,则是后端启动时在日志中输出过一次的那一行(预置用户)。
  • 确实能够访问提供商:

demo-aws-credentials 密钥中保存着真实的访问密钥:要么在首次启动前设置了 DEMO_AWS_ACCESS_KEY_ID / DEMO_AWS_SECRET_ACCESS_KEY,要么在密钥中编辑该密钥。这次运行会真实启动一个 EC2 实例,在您终止它之前会持续产生费用。

该访问密钥的 IAM 用户需要一个策略,允许其解析 AMI、查询网络和密钥对,并启动实例。下面的策略已经足够:

{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ResolveAmi",
"Effect": "Allow",
"Action": "ssm:GetParameter",
"Resource": "arn:aws:ssm:*::parameter/aws/service/*"
},
{
"Sid": "LookupAndLaunch",
"Effect": "Allow",
"Action": [
"ec2:DescribeImages",
"ec2:DescribeVpcs",
"ec2:DescribeSubnets",
"ec2:DescribeSecurityGroups",
"ec2:DescribeKeyPairs",
"ec2:DescribeInstances",
"ec2:RunInstances",
"ec2:CreateTags"
],
"Resource": "*"
}
]
}

第一条语句只读取 AWS 发布最新 AMI ID 的公共参数,不读取您账户自己的参数。该策略不允许此访问密钥终止实例,请自行在 AWS 控制台中终止。

没有可用的账户?借助预置的工具模拟,同一个工作流无需连接提供商也能运行到底。这种方式在工作流仍为 草稿 时运行它,因此会跳过下面的发布步骤。

角色分工​

步骤AWSGoogle CloudAzure角色
生成工作流demo-aws-developerdemo-gcp-developerdemo-azure-developer开发人员
发布demo-aws-reviewerdemo-gcp-reviewerdemo-azure-reviewer审阅者
运行并确认结果demo-aws-requesterdemo-gcp-requesterdemo-azure-requester请求者
批准请求demo-approver-1demo-approver-1demo-approver-1审批人

下面每个步骤都从用户列表中的代理登录开始,到页眉中“正在以 … 身份操作”胶囊上的停止代理登录结束。停止这一步不能省略:以这些账户身份操作时,您受该账户角色的限制,而这些账户都不能代理登录,所以在停止之前不会再出现代理登录。在聊天界面中,点击应用栏上的 A2Flow 徽标可以回到欢迎页及其侧边栏。

1. 以 root 身份登录​

  1. 在登录页上,用户名输入 root,租户留空(root 是平台管理员,不属于任何租户),然后输入密码。点击登录。
  2. 您会进入欢迎页。应用栏中的租户选择器显示 Default,也就是演示数据所在的租户。如果选中的是其他租户,请选择它。

2. 以开发人员身份生成工作流​

  1. 打开管理侧边栏中的用户,在开发人员所在行点击代理登录。在以用户身份代理登录对话框中点击代理登录进行确认。您会回到欢迎页,页眉胶囊显示“正在以 demo-…-developer 身份操作”。
  2. 打开代理技能。列表中只有此提供商的技能,其他技能被访问控制标签隐藏了。等待其状态变为 就绪,如果仍显示 克隆中,请刷新列表;在此之前生成工作流一直处于禁用状态。
AWS:先读取价格表

打开知识库并点击 AWS EC2 Pricing。它唯一的来源 ec2-on-demand-pricing.pdf 显示为未读取。点击读取,等待其状态变为就绪。LLM 正在把价格表转换成页面,这些页面会出现在页面下,大约需要一两分钟(知识库)。在下一步中,还要在生成工作流对话框中点击选择知识库… 并选择 AWS EC2 Pricing,这样运行时代理才能查询价格。

  1. 在该行点击生成工作流。工作流名称保持不变,将下面的提示词粘贴到提示词中,然后点击生成。
向请求者询问所需的参数以及启动的日期和时间,获得 Demo Approvers 用户组的批准后,在该时间启动一个 EC2 实例。
让请求者从以下实例类型中选择:
- t4g.nano
- t4g.micro
- t4g.small
- t4g.medium
- t3.micro
- t3a.micro
- c6g.medium
- m6g.medium
- t2.micro
- t4g.large

让请求者从以下区域中选择:
- us-east-1
- us-east-2
- us-west-2

AMI 使用所请求区域中最新的 Amazon Linux 2023 映像。
使用默认的 VPC、子网和安全组。
不要创建密钥对。
在请求审批之前解析好 AMI、VPC 和子网的 ID。
在请求的时间之前不要启动实例。
根据 AWS EC2 Pricing 知识库回答有关实例费用的问题,并在审批请求中附上从该知识库查到的所请求实例的月费用。
  1. 您会进入新工作流的详情页,状态为 生成中。页面会自动刷新;一两分钟后状态变为 草稿,铃铛图标上会出现“工作流草稿已就绪”通知。打开任务模板,查看设计代理编写的步骤:收集参数、请求审批、执行工作、报告结果(生成工作流)。
  2. 点击“正在以 … 身份操作”胶囊上的停止代理登录。

3. 以审阅者身份发布​

  1. 在用户中,在审阅者所在行点击代理登录并确认。
  2. 打开工作流并点击工作流名称。查看它的任务模板;审阅者还可以点击打开设计会话来阅读设计对话,但不能加以引导。
  3. 点击发布。状态变为 已发布:设计已冻结,请求者现在可以运行它了(发布)。
  4. 点击停止代理登录。

4. 以请求者身份运行​

  1. 在用户中,在请求者所在行点击代理登录并确认。
  2. 打开工作流,在该工作流上点击运行。运行工作流对话框不提供模拟选项,因为工作流已发布,所以这是一次真实的请求。点击运行。
  3. 工作流会话随即打开,代理开始执行第一个任务,询问提示词中留给请求者决定的内容。答案固定的问题会以消息内选项的形式出现;其他情况下,输入框上方会出现一排建议回复。

不确定该选哪种实例类型?可以直接问,例如“t4g.medium 在 us-east-2 每月多少钱?和 t3.micro 相比如何?”代理会在 AWS EC2 Pricing 知识库中查询价格,并指明所参考的页面。

从提示词列出的十种实例类型和三个区域中各选一个,把启动时间定在几分钟之后,以免演练停滞,然后回答它提出的其他问题,例如实例的名称。接着代理会查询该区域最新的 Amazon Linux 2023 映像以及默认的 VPC 和子网,汇总配置和启动时间,然后提交审批。

  1. 该请求发送给 Demo Approvers 用户组,聊天中在它下方显示“正在等待审批组的决定。”,请求者无法自行决定。此时运行进入等待状态。
  2. 点击停止代理登录。

5. 以审批人身份批准​

  1. 在用户中,在 demo-approver-1 所在行点击代理登录并确认。使用 demo-approver-2 也完全可以:用户组请求以第一个决定为准。
  2. 工具栏中的铃铛图标显示一条未读通知,即该审批请求。点击它可以打开这次运行的聊天。也可以依次点击侧边栏中的审批和该行的打开工作流会话,到达同一位置。
  3. 阅读请求。在代理的摘要下方,这将授权列出了此决定将允许的调用及其输入的限制范围(请求授权的内容):

AWS MCP Server 上启动实例的调用。请将它以及摘要中的启动时间和月费用与请求者的选择进行核对。映像、VPC 和子网的查询没有列出,因为它们在请求之前就已运行,不需要审批。

  1. 想在决定之前了解更多?在聊天中输入问题并发送。例如在 AWS 选项卡中,可以问“如果这个实例只在工作日的工作时间运行,每月要花多少钱?”会话正在等待您的决定,因此会打开一个咨询选项卡,代理会根据请求的上下文和关联的知识库在那里回答(咨询)。请求者也可以加入这场对话。结束后,点击主会话选项卡返回请求。
  2. 如有需要,可以填写评论,然后点击批准。如果您开启过咨询,该决定会将其关闭。运行在同一个聊天中继续,代理完成工作后请请求者确认结果。这个问题要由请求者回答:对您来说输入框是只读的,其下方显示“正在等待发起人响应。”

如果启动时间还没到,代理会让启动操作等待,用一行文字说明何时继续,然后暂停。到时间后会话会自行恢复,无需有人一直开着聊天,随后代理启动实例(工作流会话界面)。

  1. 点击停止代理登录。

6. 回到请求者身份:确认结果​

  1. 在用户中,再次在请求者所在行点击代理登录并确认。
  2. 打开工作流执行,在这次运行上点击打开工作流会话。
  3. 代理已报告它所做的事情,正在等您回复:

过了您指定的启动时间后,代理会报告实例 ID 及其状态。如有需要,可以在 AWS 控制台中查看该实例,然后在聊天中确认。

  1. 代理以摘要收尾,最后一个任务完成,运行变为 已完成,铃铛图标上出现完成通知。
  2. 点击停止代理登录。

演练结束后​

实例会一直运行并产生费用,直到您在 AWS 控制台中终止它。

这次演练留下的两份记录值得一看:

位置显示的内容
审计日志 → 代理登录您刚才开启的每个会话:谁以谁的身份操作、在什么时间。上面的每次写入都归属于被代理的账户,所以要回答“背后究竟是谁”,靠的就是这条记录(审计跟踪)
这次运行的工具调用页面这次运行发起的每次工具调用及其出示的证书。正是您作出的批准,解锁了完成实际工作的那次调用(工具调用)