使用说明

Pega MCP+ADK代理

使用MCP（模型上下文协议）服务器和ADK（代理开发工具包）代理进行Pega案例管理的完整设置。

概述

此存储库包含两个主要组件：

Pega MCP 服务器 (pega-mcp/)-连接到Pega平台API
Pega ADK代理商 (pega-adk/)-使用MCP工具管理Pega案例的AI代理

快速开始

1.克隆存储库

git clone https://github.com/amribhatt/pega.git
cd pega

2.配置环境

# Copy environment templates
cd pega-mcp
copy env.template .env

cd ../pega-adk
copy env.template .env

编辑 .env 包含您实际凭据的文件：

pega-mcp/.env -Pega平台证书
pega-adk/.env -ADK代理配置

3.创建虚拟环境

# Create virtual environment for MCP server
cd pega-mcp
python -m venv .venv
.venv\Scripts\activate  # On Windows
# source .venv/bin/activate  # On Linux/Mac

# Install MCP server dependencies
pip install -r requirements.txt

# Create virtual environment for ADK agent
cd ../pega-adk
python -m venv .venv
.venv\Scripts\activate  # On Windows
# source .venv/bin/activate  # On Linux/Mac

# Install ADK agent dependencies
pip install -r requirements.txt

4.启动系统

终端1-启动MCP服务器：

cd pega-mcp
.venv\Scripts\activate  # On Windows
# source .venv/bin/activate  # On Linux/Mac
python server.py

终端2-启动ADK代理：

cd pega-adk
.venv\Scripts\activate  # On Windows
# source .venv/bin/activate  # On Linux/Mac
adk run pega_adk_agent

或者从web界面开始：

cd pega-adk
.venv\Scripts\activate  # On Windows
# source .venv/bin/activate  # On Linux/Mac
adk web

配置

必需的Pega证书

您需要从Pega平台获取这些信息：

Pega平台URL -您的Pega实例URL
OAuth客户端ID -OAuth2客户端标识符
OAuth客户端密码 -OAuth2客户端机密
应用程序别名 -您的Pega应用程序别名

环境文件

复制模板文件并使用您的凭据进行编辑：

pega-mcp/.env -MCP服务器配置：

PEGA_BASE_URL=https://your-pega-instance.com
PEGA_CLIENT_ID=your_client_id
PEGA_CLIENT_SECRET=your_client_secret
APP_ALIAS=your_app_alias

pega-adk/.env -ADK代理配置：

MCP_SERVER_URL=http://localhost:8080/mcp/
AI_MODEL=gemini-2.0-flash
AGENT_NAME=pega_adk_agent

用法

MCP服务器功能

MCP服务器提供以下工具：

验证连接 -测试与Pega平台的连接
获取案例类型 -列出可用的案例类型
创建案例 -使用指定的案例类型创建新案例

ADK代理功能

ADK代理可以：

通过MCP工具连接到Pega平台
列出可用的案例类型
创建新案例
提供有关案例管理的自然语言响应

交互示例

User: "List available case types"
Agent: "Found 3 case types:
  1. Home Loan Application (ID: H-28021)
  2. Credit Card Application (ID: C-15045)
  3. Personal Loan Request (ID: P-89012)"

User: "Create a home loan case"
Agent: "Case created successfully with ID: LOAN-2024-001"

项目结构

pega/
├── README.md               # This file
├── pega-mcp/              # MCP Server
│   ├── server.py          # MCP server implementation
│   ├── tools.py           # Pega API tools
│   ├── resources.py       # MCP resources
│   ├── requirements.txt   # MCP dependencies
│   ├── env.template      # Environment template
│   └── dx-apis/          # API documentation
└── pega-adk/             # ADK Agent
    ├── pega_adk_agent/
    │   └── agent.py      # ADK agent implementation
    ├── requirements.txt   # ADK dependencies
    └── env.template      # Environment template

故障排除

常见问题

“缺少配置”错误
- 复制 env.template 向 .env 在两个目录中
- 编辑 .env 包含您实际凭据的文件
- 确保提供了所有必需的Pega凭据
连接失败
- 验证您的Pega平台URL是否正确
- 检查OAuth凭据是否有效
- 确保与Pega实例的网络连接
MCP服务器无法启动
- 检查端口8080是否可用
- 验证虚拟环境是否已激活
- 验证是否已安装所有依赖项
- 检查 .env 文件存在于 pega-mcp/ 目录
ADK代理无法连接
- 确保MCP服务器在localhost:8080上运行
- 检查中的MCP服务器URL pega-adk/.env
- 验证虚拟环境是否已激活
- 验证是否安装了ADK依赖项
- 使用 adk run pega_adk_agent 或 adk web 启动代理

安全说明

.env 文件被排除在Git之外（请参见 .gitignore)
永远不要将真实凭据提交给版本控制
确保您的OAuth凭据安全
为了安全起见，安装脚本屏蔽了秘密输入

发展

添加新工具

添加新的Pega API工具：

添加功能 pega-mcp/tools.py
在中注册工具 pega-mcp/server.py
更新中的代理说明 pega-adk/pega_adk_agent/agent.py

自定义代理

编辑 pega-adk/pega_adk_agent/agent.py 致：

更改AI模型
修改代理指令
添加自定义工具
更新代理行为

ADK命令

adk run pega_adk_agent -在终端模式下启动代理
adk web -使用web界面启动代理
adk --help -显示所有可用命令

许可证

该项目旨在教育和发展。在使用生产Pega系统时，确保符合您组织的政策。