Semantica 是一项面向 semantica-agi/semantica 的操作技能,该上游工具是一个 Python 图形原生知识工程工具包,覆盖文档摄入、解析、抽取,以及图存储、三元组存储和向量存储等环节。
用途:帮助使用者在该工具包中完成知识工程相关的操作规划,包括选择数据摄入与解析路径、实体抽取流程,以及图/三元组/向量存储后端。
主要能力(据技能说明):
- 任务分层选择:可针对包 API、semantica CLI、独立 server/worker/explorer、MCP 或某个可选连接器分别处理任务。
- 依赖管理:要求从固定的 pyproject.toml 中确认确切的 extra 与后端,再提出安装建议;建议构建最小环境、仅添加必要 extra,除非用户明确要求并接受完整依赖体积,否则避免使用 [all]。
- 后端区分:区分包内图存储后端(如 Neo4j、FalkorDB、Neptune、AGE)与整体工具包,说明连接器前置条件,并区分离线代码检查与运行时、服务或供应商验证。
- 安全与授权:在配置模型/供应商、数据库、云服务或 MCP 客户端之前,需就凭据使用、外部调用、上传、成本、数据访问和配置变更获得明确批准;不索取或打印密钥值,优先使用文档化的环境/配置引用与本地端点。
使用方式:
- 通过 semantica --help 或其子命令帮助了解 Click 命令行界面,而非猜测参数。
- python -m semantica.mcp_server 会委派到 MCP 服务器入口,但仅此并不构成客户端配置或已运行的服务器。
- 在给出后端/供应商建议前先阅读 references/upstream.md;源元数据不能证明依赖已安装或服务健康。
适用场景示例:询问摄入文档并将三元组存入 Oxigraph 需要哪些 Semantica extra;在不使用凭据的情况下排查 Semantica CLI/MCP 启动失败;规划最小的本地解析与实体抽取流水线。
限制:技能说明将命令与数据流定位为范围有限的示例,确切语法需检查已安装的 CLI 帮助或源码。参考资料仅包含 references/upstream.md(支持的安装/运行时入口、extras、限制、许可与安全)、references/source.json(选定固定文件的 SHA256,并非整版证明)以及 evals/evals.json(编写的路由与边界场景,非已执行的模型质量测试)。