构建你的第一个智能体
分步构建一个研究型智能体。
构建你的第一个智能体
做一个研究型智能体:接收主题、调用工具、产出结构化报告。这是 SDK 路径:Agent + Task + AgentExecutor。Near 聊天请走 agx serve,见 快速上手。
第 1 步:安装
bash
1pip install agenticx2export OPENAI_API_KEY="your-key"
第 2 步:定义工具
python
1from agenticx.tools import tool2import httpx34@tool5def search_web(query: str) -> str:6 """按主题搜索网页。78 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.text1718@tool19def fetch_page(url: str) -> str:20 """抓取网页前 5000 个字符。2122 Args:23 url: 要抓取的 URL24 """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 Agent23research_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, AgentExecutor2from agenticx.llms import OpenAIProvider34task = Task(5 description="调研:多智能体 AI 与软件开发",6 expected_output=(7 "结构化调研报告,含:\n"8 "1. 摘要\n"9 "2. 关键发现\n"10 "3. 详细分析\n"11 "4. 来源"12 ),13)1415executor = 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,不是裸字符串。