build_agent_profile turns a configured Agent into a reusable, stackable profile JSON. Use it after you have tuned an Agent’s parameters, tools, or system prompt and want to save that configuration for reuse in another project or Agent.

What It Does

The operator inspects the Target Agent, compares profile-safe custom parameters against their defaults, and fills detection tables with the changes it finds. It can include selected parameter changes, configured tools from the Agent tool sequence, and the Agent’s system prompt. Saving writes a JSON profile to the selected user, project, or custom profile folder.

The preview table shows the profile sections that will be saved, including selected parameter values, tool entries, system prompt handling, and portability warnings.

Typical Workflow

1. Set Target Agent to the Agent COMP you want to profile.
2. Pulse Detect Changes to populate the detected parameter and preview tables.
3. Set Profile Name and, if helpful, Description.
4. Choose Scope to narrow the profile to Agent, Model, Tools, or another page pattern.
5. Use Include Tools and System Prompt to decide whether tool sequence entries and prompt text belong in the profile.
6. Use Select All or Select None when you need to reset the included rows for the current scope.
7. Review the profile_preview table, then pulse Save Profile.

Inputs And Outputs

• Inputs: No connector inputs. Set Target Agent from the parameter panel.
• Output 1: The current profile preview table, showing the selected profile content before saving.
• Internal tables: detected_pars holds the full detection result and profile_preview shows what Save Profile will write.

Agent Tool Use

build_agent_profile exposes GetTool() as a tool named by Tool Name, defaulting to build_agent_profile. An agent can set the profile name, scope, description, tool inclusion, system prompt mode, select or clear scoped rows, preview the profile, and save it.

It also declares a Build Agent Profile skill. When an Agent gathers that skill context, this operator detects the current Target Agent and supplies the model with the changed parameters, tool sequence, system prompt excerpt, and any portability warnings.

Works Well With

• agent: Provides the configured Agent that will be inspected and can also call the profile-building tool.
• build_agent_skill: Complements profile authoring when you are packaging both reusable Agent configuration and reusable skill behavior.

Gotchas

• Run Detect Changes before saving; Save Profile uses the current detection result and included rows.
• Profile Name is required before saving and is normalized into the JSON filename.
• User Profiles output depends on the active ChatTD Python venv. If that path is unavailable, the operator falls back to the project .lops/agent_profiles folder.
• Absolute OP paths outside the target Agent are kept but flagged as portability warnings. Internal child paths are converted to relative paths.
• If only part of the model selection group is included, the operator saves the profile but logs a warning because model settings may be incomplete.

Parameters

Build Profile

Target Agent (Targetagent) op('build_agent_profile').par.Targetagent OP

Agent operator to inspect for profile-worthy parameter changes.

Default:

"" (Empty String)

Detect Changes (Detect) op('build_agent_profile').par.Detect Pulse

Compare the target agent against defaults and build the detection tables.

Default:

False

Detection Header

Changedcount (Changedcount) op('build_agent_profile').par.Changedcount Str

Read-only count of changed parameters in the current scope.

Default:

"" (Empty String)

Toolcount (Toolcount) op('build_agent_profile').par.Toolcount Str

Read-only count of tools found in the target agent tool sequence.

Default:

"" (Empty String)

Hasprompt (Hasprompt) op('build_agent_profile').par.Hasprompt Str

Read-only system prompt summary from the target agent.

Default:

"" (Empty String)

Save Profile Header

Profile Name (Profilename) op('build_agent_profile').par.Profilename Str

Profile name written into the saved JSON and used to derive the output filename.

Default:

"" (Empty String)

Description (Profiledesc) op('build_agent_profile').par.Profiledesc Str

Human-readable description stored with the saved profile.

Default:

"" (Empty String)

Scope (Scope) op('build_agent_profile').par.Scope StrMenu

Page filter for which detected parameter changes are included in the profile.

Default:

*

Menu Options:

• All Pages (*)
• Agent (Agent)
• Model (Model)
• Tools (Tools)
• Agent + Model (Agent Model)
• Agent + Tools (Agent Tools)
• All except Callbacks (* ^Callbacks)

Include Tools (Includetools) op('build_agent_profile').par.Includetools Toggle

Include configured agent tools in the saved profile when tools are detected.

Default:

True

System Prompt (Includeprompt) op('build_agent_profile').par.Includeprompt Menu

Choose whether the target system prompt is omitted, replaces the profile prompt, or appends to it.

Default:

replace

Options:

none, replace, append

Output Header

Output Location (Outputlocation) op('build_agent_profile').par.Outputlocation Menu

Choose the user profiles folder, project .lops folder, or a custom folder for saved profiles.

Default:

user

Options:

user, project, custom

Output Folder (Outputfolder) op('build_agent_profile').par.Outputfolder Folder

Custom destination folder used when Output Location is Custom Folder.

Default:

"" (Empty String)

Save Profile (Saveprofile) op('build_agent_profile').par.Saveprofile Pulse

Write the currently selected profile data to JSON.

Default:

False

Parameter Selection Header

Select All (Selectall) op('build_agent_profile').par.Selectall Pulse

Include all detected parameters within the current scope.

Default:

False

Select None (Selectnone) op('build_agent_profile').par.Selectnone Pulse

Exclude all detected parameters within the current scope.

Default:

False

Tools

Tool Name (Toolname) op('build_agent_profile').par.Toolname Str

Function name exposed to agents when this operator is used as a tool.

Default:

build_agent_profile

Tool Description (Tooldescription) op('build_agent_profile').par.Tooldescription Str

Function description exposed to agents when this operator is used as a tool.

Default:

Build a stackable Agent profile from a target Agent's customized parameters. Use set_name, set_scope, optional settings, preview, then save.

Changelog

v1.0.02026-05-02

• added operator source (AgentProfilerEXT, agent_profiler, guide) - added docs/compose.json - added frozen release 0.1.0 tox
• Initial build_agent_profile structure
• Initial commit

Related Operators

• Agent
• Build Agent Skill