taolib.symphony.agent.tools

客户端侧工具定义。

定义可供 Codex 智能体在工作区内调用的工具， 当前实现为 Linear GraphQL 查询工具。

Classes

ToolResult	工具执行结果。
DynamicTool	动态工具基类。
LinearGraphQLTool	Linear GraphQL 查询工具。

Module Contents

class taolib.symphony.agent.tools.ToolResult

工具执行结果。

success: bool

是否成功。

output: str = ''

工具输出的文本内容。

error: str | None = None

错误信息。

class taolib.symphony.agent.tools.DynamicTool

动态工具基类。

所有客户端侧工具的抽象基类， 定义工具名称和调用接口。

property name: str

Abstractmethod:

工具名称。

property description: str

Abstractmethod:

工具描述。

abstractmethod handle(arguments: dict) → ToolResult

Async:

处理工具调用。

参数:

arguments -- 工具调用参数。

返回:

工具执行结果。

to_tool_definition() → dict

生成 Codex 工具定义字典。

class taolib.symphony.agent.tools.LinearGraphQLTool(api_key: str, endpoint: str = 'https://api.linear.app/graphql')

Bases: DynamicTool

Linear GraphQL 查询工具。

允许 Codex 智能体在工作区内查询 Linear API， 复用 Symphony 的 Linear 认证信息。

_api_key

_endpoint = 'https://api.linear.app/graphql'

property name: str

工具名称。

property description: str

工具描述。

async handle(arguments: dict) → ToolResult

执行 Linear GraphQL 查询。

参数:

arguments -- 包含 query 和可选 variables 的字典。

返回:

GraphQL 查询结果。

to_tool_definition() → dict

生成包含参数 schema 的工具定义。