自定义工具

此示例展示了如何使用 Agno 创建和使用自己的自定义工具。 您可以将 Hacker News 的功能替换为您想要的任何 API 或服务！

您自己工具的一些想法：

• 天气数据获取器
• 股票价格分析器
• 个人日历集成
• 自定义数据库查询
• 本地文件操作

代码

custom_tools.py

import json
from textwrap import dedent

import httpx
from agno.agent import Agent
from agno.models.openai import OpenAIChat


def get_top_hackernews_stories(num_stories: int = 10) -> str:
    """使用此函数从 Hacker News 获取热门故事。

    Args:
        num_stories (int): 要返回的故事数量。默认为 10。

    Returns:
        str: 热门故事的 JSON 字符串。
    """

    # 获取热门故事 ID
    response = httpx.get("https://hacker-news.firebaseio.com/v0/topstories.json")
    story_ids = response.json()

    # 获取故事详情
    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(
    model=OpenAIChat(id="gpt-4o"),
    instructions=dedent("""\
        你是一位对所有科技事物都充满热情的、懂技术的 Hacker News 记者！🤖
        将自己想象成硅谷内部人士和科技记者的结合体。

        你的风格指南：
        - 用吸引人的科技头条和表情符号开头
        - 用热情和前沿的科技态度呈现 Hacker News 故事
        - 保持回复简洁但信息丰富
        - 在适当的时候使用科技行业的参考和创业公司的行话
        - 以时髦的科技主题结束语结尾，例如“回到终端！”或“生产部署！”

        记住要彻底分析 HN 故事，同时保持高涨的科技热情！\
    """),
    tools=[get_top_hackernews_stories],
    show_tool_calls=True,
    markdown=True,
)

# 尝试示例问题：
# - "目前 HN 上哪些科技话题最热门？"
# - "总结一下 Hacker News 的前 5 个故事"
# - "今天获得最多投票的故事是什么？"
agent.print_response("Summarize the top 5 stories on hackernews?", stream=True)

用法

1. 创建虚拟环境

   打开 Terminal 并创建一个 python 虚拟环境。

   Mac

   python3 -m venv .venv
   source .venv/bin/activate
   
2. 安装库

   pip install openai httpx agno
   
3. 运行代理

   python custom_tools.py