IBM存储扩展代理
用于管理IBM Storage Scale操作的代理集合。目前包括一个配置代理。
概述
此集合目前包括Scale Provisioning Agent，它提供了一个会话界面，用于管理IBM Storage Scale文件集、快照和其他存储操作。这些代理使用LangChain和LangGraph构建，与IBM Storage Scale MCP（模型上下文协议）服务器集成，在用户批准的情况下安全执行操作。
先决条件
- Python 3.12或更高版本
- IBM存储规模MCP服务器 运行和可访问
- Ollama与兼容型号（默认：qwen3:最新）
安装
- 克隆存储库：
git clone https://github.com/IBM/ibm-storage-scale-agents.git
cd ibm-storage-scale-agents- 使用uv安装依赖项：
uv sync或者使用pip：
pip install -e .配置
编辑 config/agents_settings.ini 要配置代理，请执行以下操作：
LLM配置
[llm]
model_name = ollama_chat/qwen3:latestMCP服务器配置
选项1:HTTP传输
[mcp]
transport = http
url = http://127.0.0.1:8000/mcp选项2：标准运输
[mcp]
transport = stdio
command = /path/to/uv
args = --directory /path/to/scale-mcp-server run scale-mcp-server --transport stdio日志记录配置
[logging]
level = DEBUG
format = json
log_path = logs/agents.log
max_bytes = 10485760
backup_count = 5注： 所有代理写入单个共享日志文件(logs/agents.log)以便于调试和日志关联。
可用代理
用法
启动代理
运行交互式CLI：
python main.py或使用紫外线：
uv run python main.py故障排除
MCP连接问题
- 验证MCP服务器是否正在运行且可访问
- 检查中的传输配置
agents_settings.ini
- 查看日志文件(
logs/agents.log)连接错误
未找到型号
确保Ollama正在运行并且模型可用：
ollama list
ollama pull qwen3:latest工具执行失败
检查：
- MCP服务器具有适当的IBM Storage Scale API凭据
- 可以从MCP服务器访问Scale集群
- 工具名称与MCP服务器公开的名称匹配
报告问题和反馈
对于问题、疑问或功能请求，请在存储库中打开问题。
贡献代码
欢迎通过Pull Requests进行贡献。请根据位于以下地址的开发商原产地证书（DCO）提交您的第一个Pull Request DCO.md 使用您的姓名和电子邮件地址。
- 分叉存储库 并为您的功能或错误修复创建一个新的分支
- 进行更改 遵循现有的代码样式和约定
- 测试您的更改 彻底确保它们按预期工作
- 提交拉取请求 清楚地描述您的更改
- 签署DCO 通过将您的姓名和电子邮件地址添加到拉取请求中的DCO.md文件中
免责声明
本软件按“原样”提供，不提供任何形式的保证，包括但不限于其安装、使用或性能。我们不对因使用它们而造成的任何损坏、费用或数据丢失负责。您有责任在任何生产环境中使用之前彻底审查和测试您运行的任何脚本。此内容如有更改，恕不另行通知。