Struct FunctionTool 

pub struct FunctionTool<F>
where
    F: Fn(ToolInput, &AgentContext) -> Pin<Box<dyn Future<Output = ToolResult> + Send + '_>> + Send + Sync,
{ /* private fields */ }

函数工具

从函数创建工具

示例

use mofa_foundation::agent::tools::FunctionTool;

async fn my_tool_fn(input: ToolInput, ctx: &AgentContext) -> ToolResult {
    let message = input.get_str("message").unwrap_or("default");
    ToolResult::success_text(format!("Processed: {}", message))
}

let tool = FunctionTool::new(
    "my_tool",
    "A custom tool",
    serde_json::json!({
        "type": "object",
        "properties": {
            "message": { "type": "string" }
        }
    }),
    my_tool_fn,
);

Implementations

impl<F> FunctionTool<F>

where F: Fn(ToolInput, &AgentContext) -> Pin<Box<dyn Future<Output = ToolResult> + Send + '_>> + Send + Sync,

pub fn new( name: impl Into<String>, description: impl Into<String>, parameters_schema: Value, handler: F, ) -> FunctionTool<F>

创建新的函数工具

pub fn with_metadata(self, metadata: ToolMetadata) -> FunctionTool<F>

设置元数据

Trait Implementations

impl<F> Tool for FunctionTool<F>

where F: Fn(ToolInput, &AgentContext) -> Pin<Box<dyn Future<Output = ToolResult> + Send + '_>> + Send + Sync,

fn name(&self) -> &str

工具名称 (唯一标识符)

fn description(&self) -> &str

工具描述 (用于 LLM 理解)

fn parameters_schema(&self) -> Value

参数 JSON Schema

fn execute<'life0, 'life1, 'async_trait>( &'life0 self, input: ToolInput, ctx: &'life1 AgentContext, ) -> Pin<Box<dyn Future<Output = ToolResult> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, FunctionTool<F>: 'async_trait,

执行工具

fn metadata(&self) -> ToolMetadata

工具元数据

fn validate_input(&self, input: &ToolInput) -> Result<(), AgentError>

验证输入

fn requires_confirmation(&self) -> bool

是否需要确认

fn to_llm_tool(&self) -> LLMTool

转换为 LLM Tool 格式