Agents API
AgenticX 智能体 API 参考。
agenticx.agents
Agent
python
1class Agent(BaseModel):2 id: str3 name: str4 role: str5 goal: str6 backstory: str = ""7 organization_id: str8 max_iter: int = 109 verbose: bool = False
核心智能体定义。智能体本身无状态——所有状态保存在执行器上下文中。
AgentExecutor
python
1class AgentExecutor:2 def __init__(3 self,4 agent: Agent,5 llm: BaseLLMProvider,6 tools: list[Callable] = [],7 memory: MemoryManager | None = None,8 tracer: BaseTracer | None = None,9 human_in_the_loop: HumanInTheLoop | None = None,10 sanitizer: InputSanitizer | None = None,11 policy: PolicyEngine | None = None,12 ): ...1314 def run(self, task: Task) -> str: ...15 async def arun(self, task: Task) -> str: ...
Task
python
1class Task(BaseModel):2 id: str = ""3 description: str4 expected_output: str = ""5 context: dict = {}
Tool 装饰器
python
1from agenticx.tools import tool23@tool4def my_tool(param: str) -> str:5 """Tool description.67 Args:8 param: Parameter description910 Returns:11 Output description12 """13 return f"Processed: {param}"
常见模式
基础智能体
python
1from agenticx import Agent, Task, AgentExecutor2from agenticx.llms import OpenAIProvider34agent = Agent(5 id="my-agent",6 name="Assistant",7 role="Helper",8 goal="Assist users"9)1011task = Task(description="Help me with...")1213executor = AgentExecutor(14 agent=agent,15 llm=OpenAIProvider(model="gpt-4o")16)1718result = executor.run(task)
带工具
python
1@tool2def search(query: str) -> str:3 return f"Results for: {query}"45executor = AgentExecutor(6 agent=agent,7 llm=OpenAIProvider(model="gpt-4o"),8 tools=[search]9)
带记忆
python
1from agenticx.memory import MemoryManager23executor = AgentExecutor(4 agent=agent,5 llm=OpenAIProvider(model="gpt-4o"),6 memory=MemoryManager()7)
!!! tip "完整 API 参考"
基于源码自动生成的 API 文档即将推出。在此之前,请参阅 GitHub 源码。