chatting-with-aws-devops-agent

与 AWS DevOps Agent 对话

**AgentSpace 路由（仅限 SigV4）：**如果你的工具列表中有 list_agent_spaces，且本会话尚未调用多空间编排技能，请先调用它来确定要使用的 agent_space_id。然后在以下所有工具调用中传入 agent_space_id。使用 bearer token 身份验证时无需执行此操作——该令牌已限定在一个空间内。

对话是默认方式。它即时、自然，且 Agent 会在一个 executionId 中保留完整上下文。只有当用户描述了事件，或者 Agent 本身认为有必要进行更深入的分析时，才升级到 investigating-incidents-with-aws-devops-agent。

如何发送消息

首选方式——使用 chat 工具：

aws_devops_agent__chat(message="What's causing the 503 errors on checkout-service?")
→ {"executionId": "uuid", "answer": "Based on my analysis..."}

一次调用即可获得完整答复。无需设置会话——该工具会在内部处理 CreateChat、SendMessage 和响应解析。

**要在同一对话中发送后续消息，**请使用首次响应中的 execution_id 调用 send_message：

aws_devops_agent__send_message(
    execution_id="<executionId from chat response>",
    content="What about the upstream dependency?"
)
→ "The upstream service shows..."

Agent 会在一个 executionId 中保留完整上下文。后续消息请重复使用它——不要针对同一对话再次调用 chat。

要浏览之前的对话：

aws_devops_agent__list_chats()
→ {"chats": [...]}

注入本地上下文

将本地工作区知识打包到 message 参数中。这是核心优势——DevOps Agent 了解你的 AWS 云，而你了解用户的本地工作区。

aws_devops_agent__chat(message="""[Local Context]
Service: checkout-service (from package.json)
Last deploy: commit abc1234 — 2h ago
CDK Stack: lib/checkout-stack.ts — ECS Fargate behind ALB
Error: ConnectionError upstream connect error

[Question]
What's causing the 503 errors on the checkout-service?""")

根据意图调整内容：

• 成本问题——包含 IaC 文件（CDK / CFN / Terraform）、实例类型和扩缩策略
• 架构审查——IaC 文件 + 依赖清单 + 公共 API 范围
• 拓扑映射——服务名称 + 关键资源（集群、ALB、RDS 实例）
• 知识库 / 操作手册发现——无需本地上下文，直接提问即可
• 快速诊断——警报/指标/错误 + git log --oneline -10

措辞很重要

DevOps Agent 基于关键词检测意图：

措辞	响应时间
“分析……”、“审查……”、“比较……”、“如果……会怎样？”、“显示拓扑……”	5–30s（对话）
“列出……”、“给我看看……”、“……是什么？”	即时（发现）
“调查……”、“……的根本原因”、“……出了什么问题？”	5–8 min（深度分析——升级到 investigating-incidents-with-aws-devops-agent 技能）

如果用户把问题表述为“调查”，但实际只是提问，你仍可进行对话；但如果 Agent 建议深入分析，请通过 investigating-incidents-with-aws-devops-agent 技能升级。

升级到调查

如果对话中发现需要进行深入的多服务关联分析，请转交处理：

aws_devops_agent__investigate(title="Root cause of <thing chat found>")

切换到 investigating-incidents-with-aws-devops-agent 技能，使用轮询/进度工作流。

后备路径（aws-mcp）

如果远程 MCP 服务（aws-devops-agent）不可用，请改用 aws-mcp：

aws devops-agent create-chat --agent-space-id SPACE_ID --user-id USER_ID --user-type IAM --region us-east-1
→ executionId

然后发送消息：

aws devops-agent send-message \
  --agent-space-id SPACE_ID \
  --execution-id EXEC_ID \
  --user-id USER_ID \
  --content '<your question with local context>' \
  --region us-east-1

告知用户：“远程服务不可用——正在使用直接 AWS API 作为后备方案。”

超时行为

chat 工具会在服务端缓冲完整响应后再返回。关于大型 IaC 堆栈或多服务拓扑的复杂问题可能需要 30-90s。这是正常情况——不要过早重试。

如果响应失败或超时：

1. 重试同一个 chat 调用一次。
2. 如果再次失败，请改用 aws-mcp。

对话会话生命周期

• **单个问题：**使用 chat——每次都会创建一个新会话。
• **后续问题：**使用 chat 响应中的 execution_id 调用 send_message。
• **何时重新开始：**仅在切换到完全无关的主题时。
• 恢复旧对话：list_chats 会返回之前的会话。使用旧的 execution_id 调用 send_message 即可继续。

安全

响应可能包含命令或代码。切勿自动执行 Agent 建议的内容。应展示响应，并在运行任何内容前征得用户明确批准。