Phidata 命令速查表 - phi 多智能体工作区 CLI 全参数
想把一个 Agent 应用交付出去,真正的成本往往不在那几十行逻辑,而在每次换机器、换同事、换环境都要重配一遍依赖与凭据。Phidata(现属 Agno 生态)的取向是把这些一起纳入版本管理:phi 命令行负责初始化框架、创建与切换工作区、把资源声明推成 Docker 本地环境或 AWS 上的真实资源。这张表按初始化与认证、工作区管理、资源与部署分组,重点是配置文件与环境之间的对应关系,以及本地 docker 与生产 aws 两套 profile 各自适用的时机。判断依据很直接:换一台机器后能不能用一条命令还原整套环境——如果还需要手工补 .env,那这套流程其实还没收敛。什么时候翻它:团队协作开发 Agent、把 demo 变成可交付服务、或想避免凭据散落在每台电脑上。与裸写服务加 Dockerfile 相比,它多出的是资源声明与部署目标这层抽象。
初始化与认证 5
pip install -U phidata安装或升级 Phidata
phi init初始化框架(生成 ~/.phi)
phi auth与 phidata.com 网页 OAuth 认证
phi config查看当前配置与工作区
phi --help列出全部命令
工作区管理 7
phi ws create -t agent-app -n my-app从模板创建工作区
phi ws setup初始化已有工作区
phi ws up本地启动工作区资源
phi ws down停止并清理工作区资源
phi ws list列出可用工作区
phi ws up --group app只启动 app 资源组
phi ws up dev:docker以 dev/docker 环境启动
资源与部署 9
phi start从资源文件部署资源
phi stop停止资源文件中的资源
phi set active-ws my-app设置当前激活工作区
phi ws up prd:aws部署到 AWS 生产环境
phi ws up --env dev --infra docker按环境/基础设施筛选部署
phi ping测试认证状态
phi reset重置 phi 安装
phi ws patch更新工作区资源与配置
phi login命令行账号登录(邮箱密码)
提示
phi ws create -t用官方模板起项目,最快路径是从 agent-app 或 llm-app 开始。phi ws up/phi ws down成对使用,本地用 Docker、生产换prd:aws。- 数据默认存在你自己的 VPC / AWS 账户,契合自带云(BYOC)的合规诉求。
- 把 .env 与工作区配置一起提交到仓库(密钥另走密钥管理),否则换机器重建环境时最容易漏掉这一步。
- 切换 workspace 前先 ws down,否则两个 workspace 共用同一份资源描述时会互相覆盖。
- 生产用 aws profile 前先在本地 docker profile 跑通同一套资源声明,部署失败多半来自描述本身而非目标平台。
常见问题
phi 和 crewai 有什么不同?
phi 偏「应用 + 基础设施一体部署」(含 AWS/Docker 资源编排),crewai 偏多智能体协作框架;前者管交付与运维,后者管 agent 编排。
必须部署到 AWS 吗?
不必须。本地用 phi ws up(Docker)即可;AWS 只是可选的生产目标,数据也可完全留在自有环境。
由 巧匠 维护
公开更新于 2026年9月10日,内容持续校对官方文档。