Agents API
AgenticX agents API reference.
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
The core agent definition. Agents are stateless — all state lives in the executor context.
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 decorator
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}"
Common patterns
Basic agent
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)
With tools
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)
With memory
python
1from agenticx.memory import MemoryManager23executor = AgentExecutor(4 agent=agent,5 llm=OpenAIProvider(model="gpt-4o"),6 memory=MemoryManager()7)
!!! tip "Full API Reference"
Auto-generated API docs from source code are coming soon. In the meantime, refer to the source on GitHub.