← ClaudeAtlas

infra-ragflow-opslisted

RAGFlow 平台运维技能。凡是用户提到 RAGFlow、ragflowctl、知识库、dataset、RAGFlow 模型/向量库/对象存储依赖或 RAGFlow 健康检查时触发。
seed-forge/harness-ai-kit · ★ 22 · AI & Automation · score 74
Install: claude install-skill seed-forge/harness-ai-kit
# infra-ragflow-ops 用于 RAGFlow 平台 day-2 运维。RAGFlow 是 AI/RAG 平台型应用,本轮作为基础设施纳入治理。 ## 配置上下文 本技能依赖以下配置,AI 在运行时按如下优先级解析: 1. 用户对话中明确提供的值(最高优先级) 2. `~/.harness-ai-kit/config.yaml` 中 `assets.ragflowctl` 或 `global` 段 3. `config.defaults.yaml` 中的默认值 如用户未提供且无默认值的 required 字段,**必须主动询问用户**。 禁止从 AGENTS.md 或脚本中读取硬编码配置值。 | 配置项 | 类型 | 必填 | 说明 | |--------|------|------|------| | `ragflow_url` | string | ✅ | RAGFlow 服务 URL(默认 `http://ragflow.{base_domain}:11281`) | 配套 CLI:`ragflowctl`(配置来源:`~/.harness-ai-kit/config.yaml` → `assets.ragflowctl`) ## 边界 - 本 skill 负责:RAGFlow 服务健康、dataset/知识库 API 探活、模型/向量库/对象存储依赖检查、运行台账。 - 模型消费规则交给 `infra-aimodel-ops`。 - 数据库/向量库/对象存储连接规则交给 `infra-datasource-ops` 和 `infra-minio-ops`。 ## 推荐输出格式 执行完毕后输出极简回执:**状态**(✅ 成功 / ⚠️ 部分成功 / ❌ 失败)+ **关键结果**(1-2 行,如操作对象、产出位置、下一步)。无需强制套用大表格。 ## 操作顺序 1. 运行 `ragflowctl doctor --profile 组织内部集群 --json`。 2. 检查依赖:模型 endpoint、数据库、向量库、对象存储。 3. 只读列 dataset/知识库,再评估是否需要变更。 4. 变更前输出 dry-run 计划。 ## 模型治理(ragflowctl ≥0.3.0,v0.26 模型体系) v0.26 起 RAGFlow 模型管理重构为 provider/instance/model 三级(`tenant_model_*` 表),一律经 `ragflowctl llm` 命令组操作,不开 UI、不手写 SQL: - `llm providers|factories|models|remote-models|default`:只读盘点 - `llm add-instance --models <name:type>`:创建实例(服务端强制真实探测,--models 至少一项) - `llm add-model`:追加模型(纯登记不探测;`--type asr/vision` 自动映射 `speech2text/image2text`) - `llm set-default --type chat|embedding|rerank|asr|tts`:设租户默认模型(引用格式 `model@instance@provider`) - `llm remove-provider`:连实例/模型整体删除 - `dataset set-embedding`:存量库 embedding 引用重绑(同