.NET API
AgentSkillScriptDefinition
Tracon.Abstractions.dllA server-executable script stored together with an AgentSkillDefinition.
public sealed record AgentSkillScriptDefinition : IEquatable<AgentSkillScriptDefinition>- Inheritance
- object ← AgentSkillScriptDefinition
- Implements
- IEquatable<AgentSkillScriptDefinition>
- Inherited Members
- object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Remarks
Section titled “Remarks”This content runs on the server. Creating the record does
not grant execution permission: execution requires
TraconSkillScriptOptions.AllowStoredScripts to be enabled on
the code side, and a SkillScriptGrant pinned to this content
(AgentSkillScriptDefinition.ContentHash). Changing the content stops the script until it
is granted again.
Constructors
Section titled “Constructors”AgentSkillScriptDefinition()
Section titled “ AgentSkillScriptDefinition()”public AgentSkillScriptDefinition()Properties
Section titled “Properties”Content
Section titled “ Content”The script’s source text.
public required string Content { get; init; }Property Value
Section titled “Property Value”ContentHash
Section titled “ ContentHash”The hash of what runs: the extension, the content, and the argument schema. Computed, never stored; a value sent in a request is ignored.
public string ContentHash { get; }Property Value
Section titled “Property Value”Remarks
Section titled “Remarks”A grant for this script (SkillScriptGrant.ScriptName set) pins this value; the script runs only while its current hash equals the pinned one. AgentSkillScriptDefinition.Description and AgentSkillScriptDefinition.Name are not part of it: the description reaches only the model, and the name is the grant’s key. 64 upper-case hexadecimal characters (SHA-256).
Description
Section titled “ Description”A description telling the model what the script does.
public string? Description { get; init; }Property Value
Section titled “Property Value”Extension
Section titled “ Extension”The file extension (without the dot, for example py). The
interpreter is selected from the allowlist through this value.
public required string Extension { get; init; }Property Value
Section titled “Property Value”The script name, unique within the skill.
public required string Name { get; init; }Property Value
Section titled “Property Value”ParametersSchema
Section titled “ ParametersSchema”The argument schema reported to the model. Must be a valid JSON Schema object; if null, the script is called with no arguments.
public string? ParametersSchema { get; init; }Property Value
Section titled “Property Value”Methods
Section titled “Methods”Equals(object?)
Section titled “ Equals(object?)”public override bool Equals(object? obj)Parameters
Section titled “Parameters”obj object?
Returns
Section titled “Returns”Equals(AgentSkillScriptDefinition?)
Section titled “ Equals(AgentSkillScriptDefinition?)”public bool Equals(AgentSkillScriptDefinition? other)Parameters
Section titled “Parameters”other AgentSkillScriptDefinition?
Returns
Section titled “Returns”GetHashCode()
Section titled “ GetHashCode()”public override int GetHashCode()Returns
Section titled “Returns”ToString()
Section titled “ ToString()”public override string ToString()Returns
Section titled “Returns”Operators
Section titled “Operators”operator ==(AgentSkillScriptDefinition?, AgentSkillScriptDefinition?)
Section titled “ operator ==(AgentSkillScriptDefinition?, AgentSkillScriptDefinition?)”public static bool operator ==(AgentSkillScriptDefinition? left, AgentSkillScriptDefinition? right)Parameters
Section titled “Parameters”left AgentSkillScriptDefinition?
right AgentSkillScriptDefinition?
Returns
Section titled “Returns”operator !=(AgentSkillScriptDefinition?, AgentSkillScriptDefinition?)
Section titled “ operator !=(AgentSkillScriptDefinition?, AgentSkillScriptDefinition?)”public static bool operator !=(AgentSkillScriptDefinition? left, AgentSkillScriptDefinition? right)Parameters
Section titled “Parameters”left AgentSkillScriptDefinition?
right AgentSkillScriptDefinition?