存储管理代理工具

IBM Storage Scale Agents 是一组用于管理 IBM Storage Scale 操作的代理工具,包括配置代理和信息生命周期管理代理,提供文件集、快照和存储操作的交互式管理。

  • by IBM
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 IBM/ibm-storage-scale-agents

使用说明

IBM存储扩展代理

用于管理IBM Storage Scale操作的代理集合。目前包括一个配置代理。

概述

此集合目前包括Scale Provisioning Agent,它提供了一个会话界面,用于管理IBM Storage Scale文件集、快照和其他存储操作。这些代理使用LangChain和LangGraph构建,与IBM Storage Scale MCP(模型上下文协议)服务器集成,在用户批准的情况下安全执行操作。

先决条件

安装

  1. 克隆存储库:
git clone https://github.com/IBM/ibm-storage-scale-agents.git
cd ibm-storage-scale-agents
  1. 使用uv安装依赖项:
uv sync

或者使用pip:

pip install -e .

配置

编辑 config/agents_settings.ini 要配置代理,请执行以下操作:

LLM配置

[llm]
model_name = ollama_chat/qwen3:latest

MCP服务器配置

选项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)以便于调试和日志关联。

可用代理

代理 描述 文档
资源调配代理 管理IBM Storage Scale文件集、快照和存储操作 自述文件
ILM代理 管理信息生命周期管理策略和操作 自述文件

用法

启动代理

运行交互式CLI:

python main.py

或使用紫外线:

uv run python main.py

故障排除

MCP连接问题

  1. 验证MCP服务器是否正在运行且可访问

  2. 检查中的传输配置 agents_settings.ini

  3. 查看日志文件(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 使用您的姓名和电子邮件地址。

  1. 分叉存储库 并为您的功能或错误修复创建一个新的分支
  2. 进行更改 遵循现有的代码样式和约定
  3. 测试您的更改 彻底确保它们按预期工作
  4. 提交拉取请求 清楚地描述您的更改
  5. 签署DCO 通过将您的姓名和电子邮件地址添加到拉取请求中的DCO.md文件中

免责声明

本软件按“原样”提供,不提供任何形式的保证,包括但不限于其安装、使用或性能。我们不对因使用它们而造成的任何损坏、费用或数据丢失负责。您有责任在任何生产环境中使用之前彻底审查和测试您运行的任何脚本。此内容如有更改,恕不另行通知。