phidata快速开始

news2025/3/13 11:54:35

文章目录

- 什么是phidata
- - 主要特点
- 安装
- 官方demo
- - 创建一个 Web 搜索代理
- PhiData开发workflow应用
- Tools
- Agent UI

什么是phidata

github: https://github.com/phidatahq/phidata
官方文档：https://docs.phidata.com/introduction

Phidata is a framework for building multi-modal agents and workflows.
Phidata 是一个用于构建多模式代理和工作流的框架。

Build agents with memory, knowledge, tools and reasoning.
利用记忆、知识、工具和推理构建代理。
Build teams of agents that can work together to solve problems.
建立可以协同工作解决问题的代理团队。
Interact with your agents and workflows using a beautiful Agent UI.
使用美观的 Agent UI 与您的代理和工作流程进行交互。

主要特点

Simple & Elegant 简单而优雅
Powerful & Flexible 强大且灵活
Multi-Modal by default 默认为 Multi-Modal
Multi-Agent orchestration
多代理编排
A beautiful Agent UI to chat with your agents
漂亮的代理 UI，与您的代理聊天
Agentic RAG built-in 内置 Agentic RAG
Structured outputs 结构化输出
Reasoning built-in 内置推理
Monitoring & Debugging built-in
内置监控和调试功能

elegant
美: [ˈelɪɡənt]
英: [ˈelɪɡənt]
adj. (某物)优美的；雅致的；讲究的；(某人)苗条的
网络优雅的；高雅的；文雅的

安装

pip install -U phidata

官方demo

创建一个 Web 搜索代理

Phidata Agents are simple and elegant, resulting in minimal, beautiful code.
Phidata 代理简单而优雅，从而产生最小、美观的代码。

For example, you can create a web search agent in 10 lines of code.
例如，您可以在 10 行代码中创建一个 Web 搜索代理。

pip install -U phidata openai duckduckgo-search

from phi.agent import Agent
from phi.model.openai import OpenAIChat
from phi.tools.duckduckgo import DuckDuckGo

api_key = "sk-proj-aN_YerJixxx"
web_agent = Agent(
    name="Web Agent",
    model=OpenAIChat(id="gpt-3.5-turbo", api_key=api_key),
    tools=[DuckDuckGo()],
    instructions=["Always include sources"],
    show_tool_calls=True,
    markdown=True,
)
web_agent.print_response("Tell me about OpenAI Sora?", stream=True)

使用国产deepseek模型：

from phi.agent import Agent

from phi.tools.duckduckgo import DuckDuckGo
from phi.model.deepseek import DeepSeekChat

api_key = "sk-xxxxx"

web_agent = Agent(
    name="Web Agent",
    model=DeepSeekChat(api_key=api_key),
    tools=[DuckDuckGo()],
    instructions=["Always include sources"],
    show_tool_calls=True,
    markdown=True,
)
web_agent.print_response("不是deepseek吗?", stream=True)

PhiData开发workflow应用

当前像coze、dify 这样的产品都支持workflow功能，可以可视化的定义workflow来解决一些相对负责的问题，而PhiData提供了通过code编排workflow的功能。

TODO~

Tools

工具是Agent可以运行的功能，如搜索web、运行SQL、发送电子邮件或调用api。使用工具将agent与外部系统集成。您可以使用任何python函数作为工具或使用预构建的工具包。

from phi.agent import Agent

agent = Agent(
    # Add functions or Toolkits
    tools=[...],
    # Show tool calls in the Agent response
    show_tool_calls=True
)

Available Toolkits
Toolkit是可以添加到Agent中的函数集合。Toolkit中的函数被设计成协同工作、共享内部状态并提供更好的开发体验。以下工具包可供使用
Using functions as tools
任何 python 函数都可以被代理用作工具。我们强烈建议创建特定于您的工作流的函数，并将它们添加到您的代理中。

例如，以下是如何使用 get_top_hackernews_stories 函数作为工具:

import json
import httpx

from phi.agent import Agent


def get_top_hackernews_stories(num_stories: int = 10) -> str:
    """Use this function to get top stories from Hacker News.

    Args:
        num_stories (int): Number of stories to return. Defaults to 10.

    Returns:
        str: JSON string of top stories.
    """

    # Fetch top story IDs
    response = httpx.get('https://hacker-news.firebaseio.com/v0/topstories.json')
    story_ids = response.json()

    # Fetch story details
    stories = []
    for story_id in story_ids[:num_stories]:
        story_response = httpx.get(f'https://hacker-news.firebaseio.com/v0/item/{story_id}.json')
        story = story_response.json()
        if "text" in story:
            story.pop("text", None)
        stories.append(story)
    return json.dumps(stories)

agent = Agent(tools=[get_top_hackernews_stories], show_tool_calls=True, markdown=True)
agent.print_response("Summarize the top 5 stories on hackernews?", stream=True)