Working with Agents
Use Agents to build, configure, and publish agents you can run from any workflow. An agent brings together a model connection, instructions, tools, knowledge, and memory into one reusable capability — build it once in Studio, publish it, then attach it to an AI Agent step in any workflow.
Before you begin
- Agents must be enabled for your workspace. If you do not see Agents in the left toolbar, ask your organization administrator to enable it.
- Creating an agent, and most registry items, requires permission to edit the capability library. Reviewing items for global release requires a separate permission. Ask your organization administrator if an action is unavailable to you.
Where to start
Create an agent
Walk through the five-step wizard that sets up a new agent.
Start hereExplore the agent builder
Orient to the tabs you use to configure, test, and monitor an agent.
ExplorePublish an agent
Move a draft to a published version other people and workflows can use.
PublishBuilding an agent
| Task | Guide |
|---|---|
| Create a new agent | Creating an Agent |
| Orient to the builder's tabs and top bar | The Agent Builder |
| Write instructions, run settings, and A2A delegation | Configuring an Agent |
| Attach a connection, tools, MCP sources, skills, prompts, and guardrails | Attaching Capabilities |
| Give an agent files to use as context | Adding a Knowledge Base |
| Turn on memory and inspect what an agent remembers | Configuring Memory |
Testing and monitoring an agent
| Task | Guide |
|---|---|
| Try an agent in a live test chat | Testing an Agent |
| Review every reply an agent has given | Reviewing Logs |
| Build reusable test cases and run evals against them | Running Evals and Datasets |
Publishing, sharing, and deploying
| Task | Guide |
|---|---|
| Move a draft to a published version | Publishing an Agent |
| Reuse and share connections, tools, skills, prompts, and other capability items | Managing the Capability Registries |
| Approve or reject a request to make a capability item available to every organization | Global Review |
| Attach a published agent to a workflow | Deploying an Agent in a Workflow |
Related
- AI Activities — the AI Agent activity and the other AI building blocks available on the workflow canvas.
- NxAgent User Guide — the AI assistant that helps you build inside Studio itself. This is a different feature: NxAgent assists you as you work; the agents documented here are things you build and publish for a workflow to run.