跳到正文
TAIP

产品 / 面向 AI 开发者

AgentX

预览版

在 Kubernetes 上定义和运行智能体,支持版本管理、沙箱隔离和全程追踪。

AgentX 通过 Kubernetes 自定义资源管理智能体。Agent 定义模型、系统提示词、工具、记忆和沙箱,可复用并纳入版本管理;AgentSession 表示一次运行。控制器创建经过安全加固的沙箱 Pod,运行不依赖特定模型供应商的智能体执行循环,并持续保存事件。模型通过可插拔适配器接入 InferX(兼容 OpenAI API 的 gemma-4);工具包括内置 bash / file / code / web、MCP 服务,以及将密钥保留在沙箱外的自定义宿主侧工具。同一 Agent 可配合 AgentSchedule、AgentService 和 MemoryStore 实现定时执行、常驻服务与持久化记忆。React 追踪界面、聊天界面和 taip-agent CLI 仅需 kubeconfig 即可读取实时 SSE 事件流。OIDC 登录网关(agentx-bff)负责浏览器认证、用户组与角色映射及会话权限控制;每个沙箱均采用默认拒绝访问、策略失效时默认拒绝(fail closed)的 CiliumNetworkPolicy。

产品规格

状态
v0.1.0-rc1 — 预览版,已端到端验证
CRD
Agent · AgentSession · AgentService · AgentSchedule · MemoryStore
模型
InferX 适配器(兼容 OpenAI 的 gemma-4)· 不依赖特定模型供应商的执行循环
工具
内置 bash/file/code/web · MCP(Streamable-HTTP)· 自定义宿主侧工具
追踪
PVC 持久化事件存储 · 实时 SSE · 按每次运行统计 token 用量
隔离
按会话隔离的沙箱 Pod(非 root、丢弃 capabilities)· Cilium 默认拒绝出站访问 · 可选 HMAC 鉴权
身份认证
OIDC 单点登录网关(agentx-bff)· 用户组→角色的 RBAC 映射 · 按用户隔离的会话
入口
React 追踪查看器 + 聊天界面 · taip-agent CLI · Helm + kustomize

使用示例

通过示例了解用法。

无需专用 SDK,也无需重写客户端。 AgentX 可直接与现有工具对接。

使用 Kubernetes 资源定义智能体
$ kubectl apply -f agent.yaml         # 一份支持版本管理的 Agent 定义
agent.agent.tensorstack.dev/demo  created
$ kubectl apply -f session.yaml       # 它的一次运行
agentsession/demo-run-1  created
$ kubectl get agentsession demo-run-1 -w
demo-run-1   Pending → Running → Succeeded   # 加固的沙箱 Pod
$ taip-agent trace demo-run-1          # 实时 SSE:每一步、每次工具调用、每个 token
# 用量:输入 1,284 · 输出 412 token · 归属到本次运行▌

Agent、AgentSession、AgentService、AgentSchedule、MemoryStore——agent.tensorstack.dev 上的五个 CRD。采用声明式配置,支持 GitOps,可使用现有 Kubernetes 工具查看运行状态。

核心能力

AgentX 的主要功能

01

Agent 定义支持版本管理

在 Agent 中声明模型、系统提示词、工具、记忆和沙箱,同一定义可重复运行。创建会话时,系统将解析后的 spec 保存为该会话的 ConfigMap 快照,后续修改不会影响已有运行的复现。

02

支持自主任务与交互式对话

一个 AgentSession 表示一次运行,可用于一次性任务或多轮对话。智能体在对话轮次之间进入 Idle 状态,收到新消息后继续执行;控制器管理超时、TTL 和 token 预算。

03

支持多种工具接入

bash、file、code 和 web 在沙箱内运行,MCP 服务通过 Streamable-HTTP 客户端接入。调用自定义宿主侧工具时,智能体暂停执行,等待外部结果返回后继续,工具密钥始终保留在沙箱外。

04

沙箱隔离与访问认证

每次运行使用独立 Pod,以非 root 用户身份执行,移除额外 capabilities,不挂载 ServiceAccount token,并以只读方式挂载配置。CiliumNetworkPolicy 默认拒绝出站访问,策略失效时同样默认拒绝(fail closed)。OIDC 登录网关限制用户只能访问自己的会话。标记为 ask 的工具调用会暂停等待审批,仅在获批后执行。

05

每一步都可追踪

PVC 持久化的事件存储记录每次工具调用、每条助手消息、每次状态变化与 token 计数——实时经 SSE 推送,重启后仍可回放。用量按每次运行分别统计。

06

跨会话保留记忆

MemoryStore 通过持久化 PVC 向 Agent 的各个会话提供存储,支持 RWX 访问模式。启用 retain 后,可在删除 MemoryStore 资源时保留数据。

07

定时调度与常驻服务

AgentSchedule 按带时区的 cron 计划启动 Session,支持并发策略和历史保留上限。AgentService 通过受访问控制保护的网关,将每个 HTTP 请求转换为新 Session,支持同步或异步调用。

08

界面与 CLI 共用一条事件流

React 追踪界面和聊天界面通过代理连接 AgentService 网关。taip-agent CLI 提供 run、list、get 等命令,并可使用 kubeconfig 从 Pod 日志实时查看执行记录。

工作原理

在 Kubernetes 中定义、运行和追踪智能体。

  1. 步骤 01

    编写 Agent

    使用 YAML 定义 Agent 资源,声明模型(InferX)、系统提示词、工具、记忆和沙箱,通过 kubectl apply 或 taip-agent 提交,支持 GitOps 管理。

  2. 步骤 02

    运行 Session

    创建 AgentSession 以启动任务或对话。控制器保存 spec 快照,并创建经过安全加固的沙箱 Pod,使用指定模型和工具执行任务。

  3. 步骤 03

    查看执行记录

    执行步骤、工具调用和 token 用量通过 SSE 实时推送到追踪界面、聊天界面或 taip-agent CLI。记录持久保存、支持回放,用量按本次运行统计。

  4. 步骤 04

    调度或常驻

    通过 AgentSchedule 定时运行同一 Agent,或通过 AgentService 提供常驻服务,并使用 MemoryStore 在多次运行之间保留上下文。

适用团队

适合哪些团队

  • 在自有基础设施上构建生产级智能体产品的团队
  • 需要提供统一管理的多租户智能体服务的平台团队
  • 希望通过定时任务和审批机制,使用智能体自动执行运维流程的 SRE 与运维团队
  • 需要完整追踪与回放来探索智能体系统的研究者