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

Agents API

AgenticX 智能体 API 参考。

agenticx.agents

Agent

python
1class Agent(BaseModel):
2 id: str
3 name: str
4 role: str
5 goal: str
6 backstory: str = ""
7 organization_id: str
8 max_iter: int = 10
9 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 ): ...
13
14 def run(self, task: Task) -> str: ...
15 async def arun(self, task: Task) -> str: ...

Task

python
1class Task(BaseModel):
2 id: str = ""
3 description: str
4 expected_output: str = ""
5 context: dict = {}

Tool 装饰器

python
1from agenticx.tools import tool
2
3@tool
4def my_tool(param: str) -> str:
5 """Tool description.
6
7 Args:
8 param: Parameter description
9
10 Returns:
11 Output description
12 """
13 return f"Processed: {param}"

常见模式

基础智能体

python
1from agenticx import Agent, Task, AgentExecutor
2from agenticx.llms import OpenAIProvider
3
4agent = Agent(
5 id="my-agent",
6 name="Assistant",
7 role="Helper",
8 goal="Assist users"
9)
10
11task = Task(description="Help me with...")
12
13executor = AgentExecutor(
14 agent=agent,
15 llm=OpenAIProvider(model="gpt-4o")
16)
17
18result = executor.run(task)

带工具

python
1@tool
2def search(query: str) -> str:
3 return f"Results for: {query}"
4
5executor = AgentExecutor(
6 agent=agent,
7 llm=OpenAIProvider(model="gpt-4o"),
8 tools=[search]
9)

带记忆

python
1from agenticx.memory import MemoryManager
2
3executor = AgentExecutor(
4 agent=agent,
5 llm=OpenAIProvider(model="gpt-4o"),
6 memory=MemoryManager()
7)

!!! tip "完整 API 参考"

基于源码自动生成的 API 文档即将推出。在此之前,请参阅 GitHub 源码