Rust AI Agent 框架。Agent 的调度、会话、流式输出——框架搞定。你只写三样东西：你的工具、你的提示词、你的领域知识。

phi-agent 不内置任何业务工具。 没有搜索引擎、没有数据库连接、没有代码执行器——干干净净的 Rust 运行时。Agent 需要什么工具，完全由你决定。内核原语（文件读写、Shell、子 Agent）通过 phi-kernel-tools 按需开启，全部 feature gate 控制，默认关闭。

基于 agent-base 和 agent-works 构建。phi-agent 提供基础设施，你提供工具。

生态

Crate	crates.io	说明
agent-base		轻量运行时内核——LLM 客户端、Tool trait、事件流
agent-works		开箱即用工具箱——MCP、Skills、Focus
phi-agent		完整框架——Builder 工厂、渲染器、配置、CLI 二进制

只需要运行时？ cargo add agent-base。需要完整框架？ cargo add phi-agent。

架构

graph TB
    AB[agent-base<br/>Tool trait · 运行时<br/>LLM 客户端 · 事件]

    AB --> AW[agent-works<br/>MCP · Skills · Focus]
    AB --> PKT["phi-kernel-tools<br/>内核工具<br/>（默认关闭）"]
    AB --> YT[your-tools<br/>自定义工具实现]

    AW --> PA
    PKT --> PA
    YT --> PA

    PA[phi-agent<br/>Builder 工厂<br/>渲染器 · 配置 · 会话<br/>CLI 二进制]

内核工具

全部通过 feature flag 按需开启：

为什么选择 phi-agent

你的领域，你做主。 Agent 调度循环、会话管理、流式事件、工具路由、审批拦截——框架全做了。你不用写胶水代码，专注领域逻辑。

单一二进制，零依赖。 不需要 Node.js。不需要 Python。编译出来就一个文件，丢过去就跑。cargo install，十秒起步。

每一步可审计。 每一次 LLM 调用、每一次工具执行，JSONL 全记录。会话可快照、行为可追踪，问题可定位。

快速开始

use phi_agent::{
    base_agent_builder, build_system_prompt, PhiAgent, PhiAgentConfig,
    OpenAiClient, SafetyConfig, ReasoningEffort,
};
use std::sync::Arc;

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let llm_client = Arc::new(OpenAiClient::new(
        std::env::var("LLM_API_KEY")?,
        "gpt-4o".into(),
        Some("https://api.openai.com/v1".into()),
    ));

    let builder = base_agent_builder(llm_client)
        .system_prompt(build_system_prompt())
        .register_tool(your_tool);

    let agent = PhiAgent::build(builder, PhiAgentConfig {
        model: "gpt-4o".into(),
        enable_thinking: true,
        thinking_budget: None,
        thinking_effort: ReasoningEffort::Medium,
        safety: SafetyConfig::default(),
    })?;

    let session = agent.create_session().await;
    let renderer = phi_agent::create_stdout_renderer(
        &phi_agent::OutputFormat::Terminal {
            show_thinking: true,
            show_tool_args: true,
            color: true,
        }
    );

    agent.run_turn(session, "Hello!", |event| {
        renderer.render(event)
    }).await?;

    Ok(())
}

更多示例见 examples/。

CLI

cargo install phi-agent --features shell,mcp,telemetry,logging
phi "这个目录下有什么？"

# REPL 模式
phi

# JSON 输出
phi --format json "列出文件"

文档

📖 docs.phiagent.dev

参与贡献

git clone git@github.com:hibuka-labs/phi-agent.git
cd phi-agent
cargo check

详见 CONTRIBUTING.md。

许可证

MIT — 详见 LICENSE。

联系

phiagent@hibuka.com

English