Agent Blueprint

本地服务

agentblueprint.aiAI 与智能体316 周前更新

代码仓库访问官网

关于 Agent Blueprint

Agent Blueprint 提供 CLI 和 MCP 服务，用于生成、浏览结构化业务蓝图，并将其下载为编码 Agent 可读取的 Agent Skills 目录。

主要功能

01创建业务资料
02生成用例和蓝图
03查询生成状态
04下载 Agent Skills 目录
05查看蓝图与计划摘要

适用场景

01根据现有组织资料构建蓝图
02轮询异步蓝图生成进度
03将完整蓝图文件载入编码 Agent

MCP 相关

MCP 服务提供创建资料、生成流程、浏览蓝图数据和下载蓝图的工具，并提供蓝图列表及详情资源。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "agent-blueprint": {
      "command": "npx",
      "args": [
        "-y",
        "agentblueprint"
      ],
      "env": {
        "AGENT_BLUEPRINT_API_KEY": "<AGENT_BLUEPRINT_API_KEY>"
      }
    }
  }
}

启动命令npx -y agentblueprint

需要配置的环境变量

AGENT_BLUEPRINT_API_KEY密钥API token from app.agentblueprint.ai/settings/api-tokens

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmagentblueprint0.7.15stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
customerOrgId	string	否	客户组织 ID（UUID）。合作伙伴用户访问客户组织时必填。

详细介绍

agentblueprint

Agent Blueprint 的 CLI 和 MCP 服务——提供 23 个 MCP 工具，用于创建结构化业务档案、生成流水线产物、探索蓝图数据、同步实施状态，以及下载完整的 Agent Skills 目录。输出与供应商无关，可用于 ServiceNow、Salesforce、OpenClaw 或任何平台。

CLI 快速入门

# Install globally
npm install -g agentblueprint

# Store your API token (one-time)
agentblueprint login

# List blueprints
agentblueprint list

# Get a blueprint summary (JSON to stdout)
agentblueprint get blueprint <id>

# Get other artifacts
agentblueprint get business-case <id>
agentblueprint get use-case <id>
agentblueprint get implementation-plan <id>
agentblueprint get implementation-spec <id>
agentblueprint get business-profile

# Download as Agent Skills directory
agentblueprint download <id>

# Partner cross-org access
agentblueprint list --org <customer-org-id>
agentblueprint get blueprint <id> --org <customer-org-id>

或者通过 npx 运行，无需安装：

npx agentblueprint list --token <your-api-key>
npx agentblueprint get blueprint <id> --token <your-api-key>

MCP 服务设置

通过管道传入 stdin（非交互模式）时，同一二进制文件会自动检测并进入 MCP 模式。无需单独的命令。

将其添加到 Claude Code MCP 配置（.claude/settings.json 或项目设置）中：

{
  "mcpServers": {
    "agent-blueprint": {
      "command": "npx",
      "args": ["@agentblueprint/mcp-server"],
      "env": {
        "AGENT_BLUEPRINT_API_KEY": "<your-api-key>"
      }
    }
  }
}

你也可以使用 agentblueprint serve 显式启动 MCP 服务。

获取 API 密钥

前往 Agent Blueprint Settings > API Tokens
点击“Create Token”
复制令牌（仅显示一次）

支持的无头工作流

当前范围有意保持精简：

existing PAT + existing org -> create_business_profile -> generate_use_cases -> generate_blueprint or trigger_full_pipeline -> get_generation_status -> download_blueprint

此版本不处理组织创建、OAuth 引导，或将自由格式上下文提取到业务档案中。

将蓝图下载为 Agent Skills

将蓝图下载为本地 Agent Skills 目录，任何编码 Agent 都可以从文件系统读取。推荐使用这种方式处理蓝图。

# Using the CLI (after `agentblueprint login`)
agentblueprint download <id>
agentblueprint download <id> --dir ./my-skills

# Or via npx
npx agentblueprint download --token <key> --blueprint <id>

这会创建一个 Agent Skills 目录结构：

.agent-blueprint/<blueprint-slug>/
├── SKILL.md                              # Overview + frontmatter (auto-discovered by agents)
├── references/
│   ├── business-context.md               # Use case, pain points, transformation story
│   ├── agent-specifications.md           # Full agent specs with tools, guardrails, metrics
│   ├── financial-case.md                 # ROI, cost breakdown, sensitivity, 5-year projection
│   ├── implementation-roadmap.md         # Epics, stories, timeline, roles, dependencies
│   ├── architecture-decisions.md         # Platform, pattern, integration gaps, feasibility
│   └── guardrails-and-governance.md      # Risks, mitigation, per-agent guardrails
└── scripts/
    └── validate-spec.sh                  # Structure completeness checker

Agent Skills 标准受 Claude Code、Codex、Cursor、GitHub Copilot、Windsurf 及其他 18 多种编码 Agent 支持。SKILL.md 会在激活时自动加载（约 100 个 token），参考文件则按需加载。

可用工具

工具	描述
`create_business_profile`	为现有组织创建或更新结构化业务档案
`generate_use_cases`	根据当前业务档案和准备度评估生成标准化用例
`generate_blueprint`	开始为选定用例生成蓝图，并返回 `auditId`
`trigger_full_pipeline`	为现有业务档案启动完整流水线，并返回 `jobId`
`get_generation_status`	轮询蓝图生成或完整流水线生成的状态
`list_blueprints`	列出所有蓝图（摘要）
`get_blueprint`	蓝图摘要——标题、Agent、阶段、模式
`get_business_case`	业务案例摘要——投资回报率、试点经济效益、建议
`get_implementation_plan`	实施计划摘要——史诗、时间线、用户故事数量
`get_use_case`	蓝图的用例分析
`get_implementation_spec`	实施规范元数据
`get_business_profile`	组织业务档案
`download_blueprint`	将完整蓝图下载为 Agent Skills 文件清单

generate_blueprint 和 trigger_full_pipeline 工具为异步工具。使用 get_generation_status 轮询，直至运行完成，然后调用 download_blueprint，并传入解析出的 blueprintId。

get_blueprint、get_business_case 和 get_implementation_plan 工具会返回简洁摘要，适合放入 Agent 上下文窗口。要获取完整详情（Agent 规范、财务预测、用户故事），请使用 download_blueprint 获取完整的 Agent Skills 目录。

可用资源

URI	描述
`agentblueprint://blueprints`	蓝图列表（JSON）
`agentblueprint://blueprints/{id}`	蓝图详情（Markdown）
`agentblueprint://blueprints/{id}/spec`	实施规范（Markdown）

身份验证

有三种方式可提供 API 令牌（按以下顺序检查）：

在任何命令中使用 --token <key> 标志
AGENT_BLUEPRINT_API_KEY 环境变量
agentblueprint login（保存至 ~/.config/agentblueprint/config.json）

Environment Variables

Variable	Required	Default	Description
`AGENT_BLUEPRINT_API_KEY`	No	—	Your API token (alternative to `agentblueprint login`)
`AGENT_BLUEPRINT_API_URL`	No	`https://app.agentblueprint.ai`	API base URL