API 与命令速查

API 与命令速查

本节摘要:高频启动命令、关键 HTTP 接口、SDK 核心 API、控制台常用操作的速查表。日常操作时不用翻正文,查这里。所有内容均为概念性,真实参数以本地源码与官方文档为准。

一、启动与停止命令

端口速查
  8096  → 代理层(Agent 的 baseURL 指向这)
  8125  → 控制台(浏览器打开)
  8420  → 记忆核心服务(内部 Gateway)
  8421/8424 → 知识服务(Wiki/CodeGraph)
​

二、关键 HTTP 接口

⚠️ 注意:以上接口路径为概念性,真实路径与参数以本地源码与 OpenAPI 文档为准。控制台与 SDK 都封装了这些接口,日常用控制台/SDK 即可,不必直接调 HTTP。

三、SDK 核心 API

# Python SDK 核心 API(概念性,真实签名以本地 SDK 为准)
from memory_core import MemoryCoreClient

client = MemoryCoreClient(endpoint="http://localhost:8420", key="...")

# 召回
memories = await client.recall(query="...", team_id=..., agent_id=..., user_id=...)

# 捕获(回写)
await client.capture(conversation={...}, team_id=..., agent_id=..., session_id=...)

# 工具发现与调用
tools = await client.list_tools(team_id=...)
result = await client.call_tool(tool_name="code_impact", params={...})
​

TypeScript SDK 的 API 概念一致,仅语法风格不同(如 await client.recall(...))。

四、控制台常用操作

五、环境变量速查

六、可观测后端速查

本节要点回顾

1. 启动停止:start-all.sh / stop-all.sh,端口 8096/8125/8420/8421。
2. 关键接口:auth/verify(鉴权)、tools/list+call(知识按需)、recall/capture(召回回写)。
3. SDK 核心:recall/capture/list_tools/call_tool,Python 与 TS 概念一致。
4. 控制台操作:建队/审核/配装/构建/查使用,均在控制台对应页面。
5. 环境变量:memory 组 + proxy 组凭证,Agent 改 baseURL + user-key。

下一节是常见报错排查三列表。