Learn how to manage Agents in the Appspace Assistants module. Agents are focused background workers with their own instructions and tools that an assistant can start to handle one job while the conversation continues. This article is for Account Owners who create agents, attach them to assistants, test them, and maintain them. After you finish, you can create an agent, give it tools and skills, attach it to an assistant, test it, and enable, disable, or delete it.
For: IT Administrators — Agents library and assistant attachment
Prerequisites
-
You must be the Account Owner.
-
The Assistants module must be available on your account, and conversational AI must be turned on in your account's AI settings.
How Agents Work
An agent moves one job, such as research or lookup, out of an assistant's prompt and into its own instructions and tools. Each agent has a Spawn Description that the assistant reads when it decides whether to start the agent.
-
People never choose an agent. They reach an agent only through an assistant it is attached to.
-
While an agent runs, the conversation shows that it is working and stays open, so the person can keep chatting. The agent's result arrives as one message.
-
A person can ask the assistant, in plain language, to stop a running agent or give it a further instruction.
-
Each agent has a Model Complexity setting: Auto, Low, Medium, or High. Auto is the default and chooses the level from the agent's instructions and tools. Appspace maps each level to the AI model that serves it, so you do not pick a model by name.
-
Changes to an agent take effect in the next conversation that uses it.
Open the Agents List
-
Open the main menu, then click ADMIN.
-
Point to Settings, then click Assistants.
-
In the left navigation, click Agents.
The Agents list shows each agent's Name, Status, Version, Assistants count, and when it was last Updated. You can search the list, and the search term stays after you reload the page.
Note: System agents are published by Appspace. They appear in the list, but you cannot edit, enable, disable, or delete them. Click a system agent's name to test it. You can attach system agents to assistants.
Create an Agent
-
On the Agents list, click Create.
The Create Agent builder opens on the General tab.
-
Enter an Agent Key. Use lowercase letters, numbers, and single hyphens, up to 64 characters. The key cannot start with
appspace-. -
Enter a Name.
-
Enter a Description, up to 1,024 characters. The description appears in the Agents list.
-
Optionally, choose a Model Complexity.
-
Under Spawn Description, click Edit, then describe when and why the assistant should start this agent.
-
Under Instructions, click Edit, then describe how the agent should behave when it starts.
-
Click Save.
The agent is created and the Tools, Skills, and Assistants tabs become available. New agents are enabled and start at version 1.0.0. You cannot change the agent key after you save. A duplicate key, a key in the wrong format, or a key that starts with appspace- shows a message that names the rule.
Add Tools and Skills to an Agent
-
On the Agents list, click the agent's name.
-
Click the Tools tab.
-
Click Add Tool, then choose the tools to add.
-
Click Save.
-
Click the Skills tab.
-
Click Attach Skill.
-
Search for a skill, then click Attach next to it.
Skill changes save immediately. Tools that an attached skill grants are available to the agent without being added on the Tools tab. To remove tools, select them on the Tools tab and click Remove, then click Save. To remove skills, select them on the Skills tab and click Detach.
Note: The Skills tab does not appear when Skills is disabled for your account.
Attach an Agent to an Assistant
You can attach from the agent or from the assistant. Both give the same result, and the agent's assistant count matches the assistant's agent list.
Attach From the Agent
-
Open the agent, then click the Assistants tab.
-
Click Attach.
-
In Attach Assistants, search for an assistant, then click Attach next to it.
The assistant appears in the attached list. You can also open this tab by clicking the count in the Assistants column of the Agents list.
Attach From the Assistant
-
In Assistants, open the assistant you want to configure.
-
Click the Agents tab.
-
Click Attach Agent.
-
In Attach Agents, search for an agent, then click Attach next to it.
The agent appears in the assistant's list. The assistant can now start it in its conversations. You can also open this tab by clicking the count in the Agents column of the assistants list.
Note: Attaching and detaching take effect immediately. To detach, open the row menu in the attached list and click Detach.
Test an Agent
-
On the Agents list, open the row menu for the agent and click Test.
Test Agent opens with the agent selected. You can choose a different agent from the Agent list.
-
Optionally, choose an Assistant to test with.
-
Type messages that prompt the assistant to start the agent, and watch the run.
-
To start over, click New conversation.
Only enabled agents can be tested. If you choose an assistant that does not have the agent attached, the agent is available in this test conversation only and is not attached afterward. If you leave the assistant unset, the test uses a basic test assistant. Test conversations do not appear in conversation history.
Edit, Enable, Disable, or Delete an Agent
-
Edit: Click the agent's name, or open the row menu and click Edit. If you leave the builder with unsaved changes, you are warned before they are discarded.
-
Enable or disable: Turn the Status switch on the agent's row on or off.
-
Delete: Open the row menu and click Delete.
Disabling or deleting always asks you to confirm and shows how many assistants are affected. Select the confirmation check box, then click Continue. A disabled agent keeps its attachments, but no assistant offers it until you enable it again. A deleted agent is detached from every assistant that uses it, and you cannot undo the delete. Runs already in progress finish normally.
To change several agents at once, select their check boxes, then click Enable, Disable, or Delete.

