ToolDefinition
Defines a tool that can be invoked by the model.
Inheritance
- Object
- ToolDefinition
Constructors
public ToolDefinition(String name, String description = null, JsonObject parameters = null, String displayName = null, String category = null, IReadOnlyList<String> tags = null, ToolWriteGovernanceContract writeGovernance = null, IReadOnlyList<ToolAliasDefinition> aliases = null, String aliasOf = null, ToolAuthenticationContract authentication = null, ToolRoutingContract routing = null, ToolSetupContract setup = null, ToolHandoffContract handoff = null, ToolRecoveryContract recovery = null) #Initializes a new tool definition.
Parameters
- name System.String
- Tool name.
- description System.String = null
- Tool description.
- parameters IntelligenceX.Json.JsonObject = null
- JSON schema for tool parameters.
- displayName System.String = null
- Optional human-friendly tool display name.
- category System.String = null
- Optional tool category label.
- tags System.Collections.Generic.IReadOnlyList{System.String} = null
- Optional tags used for model/tooling guidance.
- writeGovernance IntelligenceX.Tools.ToolWriteGovernanceContract = null
- Optional write-governance contract for mutating tools.
- aliases System.Collections.Generic.IReadOnlyList{IntelligenceX.Tools.ToolAliasDefinition} = null
- Optional aliases that should invoke the same tool implementation.
- aliasOf System.String = null
- Optional canonical tool name when this definition is an alias.
- authentication IntelligenceX.Tools.ToolAuthenticationContract = null
- Optional authentication contract for tools that require/declare auth behavior.
- routing IntelligenceX.Tools.ToolRoutingContract = null
- Optional routing contract for host-side orchestration.
- setup IntelligenceX.Tools.ToolSetupContract = null
- Optional setup contract for prerequisites and setup hints.
- handoff IntelligenceX.Tools.ToolHandoffContract = null
- Optional handoff contract for cross-pack argument mappings.
- recovery IntelligenceX.Tools.ToolRecoveryContract = null
- Optional recovery contract for tool-owned resilience behavior.
Methods
public ToolDefinition CreateAliasDefinition(String aliasName, String description = null, IReadOnlyList<String> tags = null) #ToolDefinitionCreates an alias definition derived from the current canonical definition.
Parameters
- aliasName System.String
- Alias tool name.
- description System.String = null
- Optional alias-specific description override.
- tags System.Collections.Generic.IReadOnlyList{System.String} = null
- Optional alias tags merged with canonical tags.
public String GetDescriptionWithTags() #StringReturns description text augmented with tag hints.
Inherited Methods
Properties
public String Description { get; } #Gets the tool description.
public JsonObject Parameters { get; } #Gets the JSON schema for tool parameters.
public String DisplayName { get; } #Gets optional human-friendly display name.
public String Category { get; } #Gets optional tool category label.
public IReadOnlyList<String> Tags { get; } #Gets optional tags associated with this tool definition. Tags are normalized to distinct deterministic ordering (ordinal-ignore-case).
public IReadOnlyList<ToolAliasDefinition> Aliases { get; } #Gets optional aliases exposed for this tool definition.
public ToolWriteGovernanceContract WriteGovernance { get; } #Gets optional write-governance contract for mutating tools.
public ToolAuthenticationContract Authentication { get; } #Gets optional authentication contract for tools that require/declare auth behavior.
public ToolRoutingContract Routing { get; } #Gets optional routing contract for host-side orchestration.
public ToolSetupContract Setup { get; } #Gets optional setup contract for prerequisites and setup hints.
public ToolHandoffContract Handoff { get; } #Gets optional handoff contract for cross-pack argument mappings.
public ToolRecoveryContract Recovery { get; } #Gets optional recovery contract for tool-owned resilience behavior.
public String AliasOf { get; } #Gets the canonical tool name when this definition represents an alias.
public String CanonicalName { get; } #Gets the canonical tool name for this definition.