Phidata 命令速查表 - phi 多智能体工作区 CLI 全参数

想把一个 Agent 应用交付出去,真正的成本往往不在那几十行逻辑,而在每次换机器、换同事、换环境都要重配一遍依赖与凭据。Phidata(现属 Agno 生态)的取向是把这些一起纳入版本管理:phi 命令行负责初始化框架、创建与切换工作区、把资源声明推成 Docker 本地环境或 AWS 上的真实资源。这张表按初始化与认证、工作区管理、资源与部署分组,重点是配置文件与环境之间的对应关系,以及本地 docker 与生产 aws 两套 profile 各自适用的时机。判断依据很直接:换一台机器后能不能用一条命令还原整套环境——如果还需要手工补 .env,那这套流程其实还没收敛。什么时候翻它:团队协作开发 Agent、把 demo 变成可交付服务、或想避免凭据散落在每台电脑上。与裸写服务加 Dockerfile 相比,它多出的是资源声明与部署目标这层抽象。

AI 命令行·共 21 条命令·最后更新 2026-09-10
phidataphiaiagentworkspaceclideployment

初始化与认证 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日,内容持续校对官方文档。

联系我们

命令或描述有误?提交反馈、商务合作或产品建议都可发送邮件给我们。

联系我们