Agents API

Agent、Task、AgentExecutor 公开字段。

agenticx.core — Agent API

本页是 agenticx.core 的 SDK 面。Near / Studio 对话走 AgentRuntime，不走这个执行器。源码在 agenticx/core/，不是 agenticx/agents/。

示意图：AgentExecutor(llm_provider=).run(agent=, task=) 返回 dict。

Agent

agenticx.core.agent.Agent（Pydantic）。常用字段：

字段	类型	说明
`id`	`str`	省略则生成 UUID
`name` / `role` / `goal`	`str`	必填人设
`backstory`	`str \	None`	可选
`organization_id`	`str`	默认 `"default-org"`
`tools`	`list`	绑定的 `BaseTool`
`max_iterations`	`int`	默认 25。没有 `max_iter` 或 `verbose`

Task

agenticx.core.task.Task：

字段	类型	说明
`id`	`str`	省略则生成 UUID
`description`	`str`	必填
`expected_output`	`str`	「完成」长什么样
`agent_id`	`str \	None`	可选指派
`context`	`dict`	额外上下文
`dependencies`	`list[str]`	其他任务 ID

AgentExecutor

构造时只传提供方。智能体在 run 时传入。

python

1from agenticx import Agent, Task, AgentExecutor
2from agenticx.llms import OpenAIProvider
3from agenticx.tools import tool
4
5@tool
6def echo(text: str) -> str:
7    """原样返回文本。"""
8    return text
9
10agent = Agent(
11    name="Assistant",
12    role="Helper",
13    goal="Assist users",
14    tools=[echo],
15)
16task = Task(description="Say hello", expected_output="一句短问候")
17
18executor = AgentExecutor(
19    llm_provider=OpenAIProvider(model="gpt-4o"),
20    tools=[echo],
21    max_iterations=50,
22)
23result = executor.run(agent=agent, task=task)

__init__ 还可收 prompt_manager、compaction_config、enable_context_compilation、execution_lane。不收 agent=、llm=、memory=、human_in_the_loop=。

run(agent, task, session_key=None) 返回 dict。配置了 ExecutionLane 时，相同 session_key 的并发调用会串行。

Tool 装饰器

python

1from agenticx.tools import tool
2
3@tool
4def my_tool(param: str) -> str:
5    """一句话说明。
6
7    Args:
8        param: 参数含义
9    """
10    return f"Processed: {param}"

见工具与智能体运行时。