如何查看AX的Actor与Worker池：kubectl ate命令完全指南

如何查看AX的Actor与Worker池kubectl ate命令完全指南【免费下载链接】axGoogles open agentic orchestration runtime项目地址: https://gitcode.com/GitHub_Trending/ax11/axAXAgent Executor是 Google 开源的 Agent 编排运行时agentic orchestration runtime它把每个会话隔离成一个可挂起、可恢复的 Actor并调度到 Kubernetes 上的 Worker 池中运行。部署到集群后新手最常问的问题就是怎么查看 Actor 和 Worker 池的实时状态答案是 Agent Substrate 提供的kubectl ate命令——两条命令即可看清整个运行态。本文带你快速上手这套诊断流程。1️⃣ 先搞懂两个核心概念在敲命令之前先理解 AX 在集群里的两个关键资源资源是什么谁来调度Actor一个会话conversation对应的隔离执行环境ID 就是会话 UUIDAX 服务端按需创建、恢复、挂起WorkerPool预热的待命 Worker 实例池Actor 被挂到其中一台 Worker 上运行Agent Substrate 控制面AX 的底层逻辑在 internal/ate/client.go 中体现每个 Actor 支持Create → Resume调度到 Worker 并获得 IP→ Suspend资源归还待命池的完整生命周期。会话结束后 Actor 会被挂起Worker 回到待命池下次--resume时再重新恢复。2️⃣ 前提AX 已部署到 Kuberneteskubectl ate只能在 AX 已部署到装有 Agent Substrate 的集群后使用。官方安装流程见 manifests/README.md一键部署脚本为 manifests/install-ax.sh./manifests/install-ax.sh --deploy-ax-server 默认部署会创建ax命名空间、ax-server副本集以及待命 Worker 池 ax-harness-workerpool默认 5 个副本。3️⃣ 一键查看所有 Actorkubectl ate get actors列出ax命名空间中所有 Actor 的当前状态kubectl ate get actors -a ax-a ax表示查询ax这个 atespace对应命名空间下的全部 Actor执行一次会话后这里能看到对应会话 ID 的 Actor 及其运行/挂起状态这是排查我的会话卡住了吗的第一步命令完整说明位于 manifests/README.md 的Inspection Diagnostics小节。4️⃣ 查看待命 Worker 池kubectl ate get workerskubectl ate get workers这条命令展示 Worker 池ax-harness-workerpool中各实例的占用情况。你可以确认待命实例数量是否与预期一致默认 replicas: 5哪些 Worker 已被 Actor 占用、哪些仍在 standby如果 Actor 长时间处于等待调度状态多半是 Worker 池容量不足可以先用这条命令定位。5️⃣ 辅助排查普通 kubectl 命令kubectl ate之外还可以用标准 kubectl 查看 Pod 层面细节# -o wide 查看节点/IP 分配-w 实时跟踪状态变化 kubectl get pods -n ax -o wide三个命令组合使用就能覆盖绝大多数运行态排查场景kubectl ate get actors -a ax→ 看会话级 Actor 状态kubectl ate get workers→ 看 Worker 池容量与占用kubectl get pods -n ax→ 看 Pod 与节点映射6️⃣ 常见问题速查FAQQ为什么查不到 ActorAAX 是会话级资源需要先通过ax --server localhost:8494 --input ...发起一次执行Actor 才会出现详见 manifests/README.md。QActor 挂起后 Worker 去哪了ASuspend 后资源自动归还待命池Worker 回到 standby 状态可用kubectl ate get workers确认。Q集群控制面版本不匹配怎么办AAX 在go.mod中固定了 Substrate 版本集群安装的 CRD 与控制面需与之对齐版本核对方法见 manifests/README.md 的Substrate compatibility一节。 相关资源部署与诊断指南manifests/README.mdWorker 池与 ActorTemplate 清单manifests/ax-deployment.yamlActor 生命周期客户端Create/Resume/Suspendinternal/ate/client.goSubstrate 集成实现Actor 调度与健康检查internal/harness/substrate/substrate.go【免费下载链接】axGoogles open agentic orchestration runtime项目地址: https://gitcode.com/GitHub_Trending/ax11/ax创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考