Skip to main content
Use the Studio Builder when you need full control over an agent’s model, prompt, features, tools, knowledge base, and deployment settings. If you want to describe your agent in plain English first and let Studio generate an initial configuration, start with the Conversational Builder and switch to Studio for fine-tuning.

Create an agent

Navigate to Agents in the sidebar and select New Agent.

Required fields

Name is the internal identifier shown in the agents list and in API responses. Model is the LLM provider and model. Select based on latency, cost, reasoning depth, and compliance requirements. Role sets the agent’s domain and persona. A specific role produces better output than a generic one. Goal is the agent’s high-level objective. Keep it to one clear sentence. Instructions define behavior, output format, edge cases, constraints, and step-by-step logic. Screenshot of the Agent Builder form showing the Name, Model, Role, Goal, and Instructions fields.

Optional features

FeatureConfig optionsNotes
MemoryCognis, Lyzr Memory, or Bedrock AgentCoreCognis is recommended for new agents
Knowledge BaseSelect one or more KBsClassic, Graph, or Semantic
ToolsPre-built, custom, or MCP toolsChoose shared or per-user auth
SkillsBuilt-in or uploaded skillsAdds reusable multi-step logic
Responsible AISelect a guardrail policyPolicies are created in the Responsible AI section
Global ContextSelect a context documentInjects org-wide instructions without per-agent duplication
Structured OutputDefine a JSON schemaForces machine-readable output
Data QuerySelect a Semantic ModelEnables natural-language-to-SQL queries
SchedulerConfigure a time triggerUse for recurring agent runs
WebhookConfigure an event triggerUse for event-driven runs

Test your agent in the Playground

The Playground lets you send messages, upload files, and iterate on instructions before deployment. Cover the following scenarios before going to production:
  • The primary use case with a typical user input
  • Ambiguous or underspecified inputs to check graceful handling
  • Requests the agent should decline, such as unsafe or out-of-scope queries
  • Tool calls: verify the agent selects the correct tool and passes valid arguments
  • Knowledge retrieval: verify the agent returns grounded, cited answers from the connected KB
Screenshot of the Agent Playground showing an HR Support Agent with suggested prompts and a chat input.

Save and versions

Every save creates a new version snapshot. You can review and restore previous versions from the Version History panel, accessible via the history icon in the top-right of the agent builder. Screenshot of the Version History panel showing version timestamps, a Current badge, and Today/This Week/All Time filter tabs.

Deploy your agent

Once you are satisfied with the Playground results, select Deploy in the top navigation. The Deploy tab confirms the agent is live and gives you everything you need to integrate it. Screenshot of the Deploy tab showing the three-step integration guide: Copy the cURL, Drop it in, Go live, with the Agent API tab and cURL command visible below. The Deploy tab provides three tabs for integration:
  • Agent API: The primary cURL command for calling your agent. Copy it and paste it into your app, site, or backend using the request format shown.
  • Agent JSON: The full agent configuration as JSON, for importing or version-controlling the agent definition.
  • How to use: Inline guidance on passing user input and rendering the response.
The three-step integration flow is: copy the cURL from the Agent API tab, drop it into your application code, then pass user input and render the response. To publish the agent to the Lyzr App Store without writing integration code, select Publish from the banner on the Deploy tab.

Update an agent

Select the agent from the Agents list to open its configuration. Modify any field and select Update to apply the changes. Re-run tests in the Playground to confirm the updates produce the intended behavior.

Next steps