agent-graphs

配置 Agent 图

您正在使用一个技能，指导您在 LaunchDarkly 中创建和管理 Agent 图。您的任务是设计图的拓扑结构，正确创建边和交接，并验证配置节点之间的路由。

前提条件

此技能要求在您的环境中配置远程托管的 LaunchDarkly MCP 服务。

必需的 MCP 工具：

• create-agent-graph -- 创建包含节点和边的新图
• get-agent-graph -- 检查图的结构和边
• list-agent-graphs -- 浏览项目中现有的图

可选的 MCP 工具：

• update-agent-graph -- 修改边、根配置或说明
• delete-agent-graph -- 永久移除图
• get-ai-config -- 检查作为节点的单个配置
• create-ai-config -- 创建用作图节点的新配置

核心概念

什么是 Agent 图？

Agent 图是一种有向图，其中：

• 节点是配置（每个配置都是一个 Agent，拥有自己的模型、提示词和工具）
• 边定义配置之间的路由（源 -> 目标）
• 边上的交接数据控制如何在 Agent 之间传递上下文
• 根配置是入口点——第一个接收用户输入的 Agent

何时使用 Agent 图

场景	示例
多步工作流	分类 Agent -> 专家 Agent -> 摘要 Agent
按意图路由	路由 Agent 决定由哪个专家处理请求
升级链	L1 支持 -> L2 支持 -> 转交人工
流水线处理	提取 -> 转换 -> 验证 -> 存储

图结构

[Root Config] --edge--> [Config A] --edge--> [Config C]
                  \--edge--> [Config B]

每条边都有：

• key -- 边的唯一标识符
• sourceConfig -- 发起路由的配置键
• targetConfig -- 路由目标的配置键
• handoff（可选）-- 转换期间传递的数据/指令

核心原则

1. 先设计，再构建：先在纸上或白板上规划节点和边
2. 一个 Agent，一项任务：每个节点都应有明确且专注的职责
3. 根配置负责路由：入口点应了解如何分发请求
4. 交接数据很重要：定义 Agent 之间流转的上下文
5. 验证完整路径：测试路由是否端到端正常工作

工作流

第 1 步：设计图

开始创建之前：

1. 确定所需的 Agent（配置）——每个 Agent 都是一个图节点
2. 规划路由：哪个 Agent 将请求交接给哪个 Agent？
3. 定义交接数据：每条边携带什么上下文？
4. 确定根配置：哪个 Agent 接收初始输入？
5. 使用 list-agent-graphs 检查现有图，避免重复
6. 使用 get-ai-config 检查现有配置，了解哪些节点已存在

第 2 步：确保节点存在

图中的每个节点都必须是现有配置。如果配置尚不存在：

1. 使用 create-ai-config 创建每个 Agent 配置
2. 根据每个 Agent 的角色设置合适的模型和提示词变体
3. 使用 get-ai-config 验证每个配置都已存在

第 3 步：创建图

使用 create-agent-graph 并提供：

• projectKey -- 包含这些配置的项目
• key -- 图的唯一标识符
• name -- 易于理解的显示名称
• description（可选）-- 说明图的用途
• rootConfigKey -- 入口配置键
• edges -- 配置之间的连接数组

{
  "projectKey": "my-project",
  "key": "support-triage-graph",
  "name": "Customer Support Triage",
  "description": "Routes customer queries to the appropriate specialist agent",
  "rootConfigKey": "triage-agent",
  "edges": [
    {
      "key": "triage-to-billing",
      "sourceConfig": "triage-agent",
      "targetConfig": "billing-specialist",
      "handoff": {"category": "billing", "priority": "normal"}
    },
    {
      "key": "triage-to-technical",
      "sourceConfig": "triage-agent",
      "targetConfig": "technical-specialist",
      "handoff": {"category": "technical", "priority": "normal"}
    }
  ]
}

第 4 步：验证

1. 使用 get-agent-graph 确认图已按正确结构创建
2. 验证边是否连接了正确的源配置和目标配置
3. 检查根配置键是否与预期的入口点一致
4. 确认需要交接数据的边上包含相应数据

报告结果：

• 已创建包含 N 个节点和 M 条边的图
• 根配置已正确设置
• 已验证所有边

边缘情况

情况	操作
配置尚不存在	先使用 create-ai-config 创建配置，再在图中引用
循环路由	允许，但要提醒用户——确保 Agent 逻辑中有终止条件
单节点图	有效但不常见——考虑是否确实需要使用图
更新边	使用 update-agent-graph——提供完整的新边列表

注意事项

• 不要在配置节点存在之前创建图
• 如果 Agent 需要从前序 Agent 获取上下文，不要忘记交接数据
• 不要创建过于复杂的图——从简单的图开始，并根据需要添加节点
• 如果不了解某个图是否正在 Agent 工作流中使用，不要删除它

其他资源

如需了解更多信息，请阅读 Agent 图。