ToolCall Element

Coming soon: This feature is not yet available. Please check back soon.

The <toolcall> element invokes tools:

<toolcall
name="calculate"
description="Performs calculation"
>
{({state}) => ({
  operation: "add",
  value: state.count
})}
</toolcall>

Prop	Type	Default
`id?`	`string`	-
`name`	`string`	-
`description?`	`string`	-

Examples

Basic Tool Call

<toolcall name="fetchData">
{() => ({
  url: "https://api.example.com/data",
  method: "GET"
})}
</toolcall>

Tool with Description

<toolcall 
name="processImage"
description="Processes an image using AI algorithms"
>
{({state}) => ({
  image: state.imageData,
  options: {
    resize: true,
    format: "jpeg",
    quality: 0.8
  }
})}
</toolcall>

Complex Tool Call

<toolcall 
name="analyzeData"
description="Performs complex data analysis"
>
{({state}) => ({
  data: state.inputData,
  parameters: {
    algorithm: state.selectedAlgorithm,
    threshold: state.threshold,
    iterations: state.maxIterations
  },
  options: {
    validateInput: true,
    cacheResults: true,
    returnFormat: "json"
  }
})}
</toolcall>

Usage Notes

Invokes external tools
Can pass parameters
Supports async operations
Handles tool responses

Best Practices

Tool Design
- Use descriptive names
- Document parameters
- Define clear purpose
- Handle errors
Parameter Handling
- Validate inputs
- Format data properly
- Handle defaults
- Check types
Error Management
- Handle failures
- Provide context
- Log issues

Common Patterns

API Integration

<toolcall 
name="apiRequest"
description="Makes an HTTP request to an API"
>
{({state}) => ({
  request: {
    url: state.endpoint,
    method: state.method,
    headers: state.headers,
    body: state.requestBody
  },
  options: {
    timeout: 5000,
    retries: 3,
    validateStatus: true
  }
})}
</toolcall>

Data Processing

<toolcall 
name="dataTransform"
description="Transforms data using specified rules"
>
{({state}) => ({
  input: state.sourceData,
  transformations: [
    { type: "filter", condition: state.filterCondition },
    { type: "map", function: state.mapFunction },
    { type: "reduce", accumulator: state.reducer }
  ],
  validation: {
    schema: state.outputSchema,
    strict: true
  }
})}
</toolcall>

Resource Management

<toolcall 
name="resourceManager"
description="Manages system resources"
>
{({state}) => ({
  operation: state.operationType,
  resources: state.targetResources,
  configuration: {
    allocation: state.allocationStrategy,
    limits: state.resourceLimits,
    priority: state.operationPriority
  },
  monitoring: {
    metrics: state.metricsToTrack,
    alerts: state.alertThresholds
  }
})}
</toolcall>

Advanced Usage

Conditional Tool Selection

<toolcall 
name={({state}) => 
  state.dataType === "image" ? "imageProcessor" : "textProcessor"
}
description="Processes content based on type"
>
{({state}) => ({
  content: state.data,
  options: state.processingOptions,
  format: state.outputFormat
})}
</toolcall>

Tool Chain

<state id="processingChain">
<toolcall name="validateInput">
  {({state}) => ({
    data: state.input,
    schema: state.schema
  })}
</toolcall>
 
<toolcall name="transform">
  {({state}) => ({
    data: state.validatedData,
    rules: state.transformRules
  })}
</toolcall>
 
<toolcall name="analyze">
  {({state}) => ({
    data: state.transformedData,
    metrics: state.analysisMetrics
  })}
</toolcall>
</state>

Tool Configuration

<toolcall 
name="configuredTool"
description="Tool with advanced configuration"
>
{({state}) => ({
  input: state.toolInput,
  config: {
    mode: state.operationMode,
    parameters: state.toolParameters,
    environment: state.executionEnvironment
  },
  hooks: {
    onStart: () => logOperation("start"),
    onComplete: (result) => processResult(result),
    onError: (error) => handleError(error)
  },
  validation: {
    preValidation: state.inputValidators,
    postValidation: state.outputValidators
  }
})}
</toolcall>

ToolCall Element

On this page