安全公告 — 恶意 litellm 版本 1.82.7 与 1.82.8 已从 PyPI 移除(存在 API 密钥外泄风险)。请卸载、轮换已暴露凭据,并升级至安全版本(如 1.82.9+)。运行 pip show litellm 以确认。 PyPI · README

构建你的第一个智能体

分步构建一个研究型智能体。

构建你的第一个智能体

做一个研究型智能体:接收主题、调用工具、产出结构化报告。这是 SDK 路径:Agent + Task + AgentExecutor。Near 聊天请走 agx serve,见 快速上手

示意图:Task 进入 AgentExecutor.run;tool_calls 回环直到文本报告。

第 1 步:安装

bash
1pip install agenticx
2export OPENAI_API_KEY="your-key"

第 2 步:定义工具

python
1from agenticx.tools import tool
2import httpx
3
4@tool
5def search_web(query: str) -> str:
6 """按主题搜索网页。
7
8 Args:
9 query: 搜索词
10 """
11 response = httpx.get(
12 "https://api.search.com/search",
13 params={"q": query, "key": "your-api-key"},
14 timeout=30,
15 )
16 return response.text
17
18@tool
19def fetch_page(url: str) -> str:
20 """抓取网页前 5000 个字符。
21
22 Args:
23 url: 要抓取的 URL
24 """
25 response = httpx.get(url, follow_redirects=True, timeout=30)
26 return response.text[:5000]

把搜索 URL 换成真实 API。@tool 会把函数包成 FunctionTool / BaseTool


第 3 步:定义智能体

python
1from agenticx import Agent
2
3research_agent = Agent(
4 id="research-agent",
5 name="Research Assistant",
6 role="Senior Research Analyst",
7 goal=(
8 "对给定主题做充分调研。"
9 "找权威来源,综合信息,产出结构清楚的报告。"
10 ),
11 backstory="你是信息综合与批判分析方面的研究者。",
12 organization_id="my-research-org",
13 max_iterations=15,
14 tools=[search_web, fetch_page],
15)

第 4 步:跑任务

python
1from agenticx import Task, AgentExecutor
2from agenticx.llms import OpenAIProvider
3
4task = Task(
5 description="调研:多智能体 AI 与软件开发",
6 expected_output=(
7 "结构化调研报告,含:\n"
8 "1. 摘要\n"
9 "2. 关键发现\n"
10 "3. 详细分析\n"
11 "4. 来源"
12 ),
13)
14
15executor = AgentExecutor(
16 llm_provider=OpenAIProvider(model="gpt-4o"),
17 tools=[search_web, fetch_page],
18)
19result = executor.run(agent=research_agent, task=task)
20print(result)

run 返回带最终产出和元数据的 dict,不是裸字符串。


接下来