Soulter
1df49d1d6f
* stage * refactor: 重构 Function Tool 管理并引入 multi agent handsoff 机制 - Updated `star_request.py` to use the global `call_handler` instead of context-specific calls. - Modified `entities.py` to remove the dependency on `FunctionToolManager` and streamline the function tool handling. - Refactored `func_tool_manager.py` to simplify the `FunctionTool` class and its methods, removing deprecated code and enhancing clarity. - Adjusted `provider.py` to align with the new function tool structure, removing unnecessary type unions. - Enhanced `star_handler.py` to support agent registration and tool association, introducing `RegisteringAgent` for better encapsulation. - Updated `star_manager.py` to handle tool registration for agents, ensuring proper binding of handlers. - Revised `main.py` in the web searcher package to utilize the new agent registration system for web search tools. * chore: websearch * perf: 减少嵌套 * chore: 移除未使用的 mcp 导入
59 lines
1.6 KiB
Python
59 lines
1.6 KiB
Python
import abc
|
|
import typing as T
|
|
from enum import Enum, auto
|
|
from ..run_context import ContextWrapper, TContext
|
|
from ..response import AgentResponse
|
|
from ..hooks import BaseAgentRunHooks
|
|
from ..tool_executor import BaseFunctionToolExecutor
|
|
from astrbot.core.provider import Provider
|
|
from astrbot.core.provider.entities import LLMResponse
|
|
|
|
|
|
class AgentState(Enum):
|
|
"""Defines the state of the agent."""
|
|
|
|
IDLE = auto() # Initial state
|
|
RUNNING = auto() # Currently processing
|
|
DONE = auto() # Completed
|
|
ERROR = auto() # Error state
|
|
|
|
|
|
class BaseAgentRunner(T.Generic[TContext]):
|
|
@abc.abstractmethod
|
|
async def reset(
|
|
self,
|
|
provider: Provider,
|
|
run_context: ContextWrapper[TContext],
|
|
tool_executor: BaseFunctionToolExecutor[TContext],
|
|
agent_hooks: BaseAgentRunHooks[TContext],
|
|
**kwargs: T.Any,
|
|
) -> None:
|
|
"""
|
|
Reset the agent to its initial state.
|
|
This method should be called before starting a new run.
|
|
"""
|
|
...
|
|
|
|
@abc.abstractmethod
|
|
async def step(self) -> T.AsyncGenerator[AgentResponse, None]:
|
|
"""
|
|
Process a single step of the agent.
|
|
"""
|
|
...
|
|
|
|
@abc.abstractmethod
|
|
def done(self) -> bool:
|
|
"""
|
|
Check if the agent has completed its task.
|
|
Returns True if the agent is done, False otherwise.
|
|
"""
|
|
...
|
|
|
|
@abc.abstractmethod
|
|
def get_final_llm_resp(self) -> LLMResponse | None:
|
|
"""
|
|
Get the final observation from the agent.
|
|
This method should be called after the agent is done.
|
|
"""
|
|
...
|