Overview
AI agents can be submitted into the Virtuoso Marketplace (Virtuoso.ai). These agents, once submitted and approved, will appear in Virtuoso Marketplace for any customer to integrate into their Yardi software.
Users who are registered to submit agents will have the option to submit agents into the marketplace. Those not registered and certified will not have this option.
This course covers how to submit an agent into Virtuoso Marketplace.
Registration and Certification
Prior to submitting agents for approval into Virtuoso Marketplace, you must first register to become a Virtuoso Certified Developer. Since you’re taking this course, you’ve already registered, but you must complete the certification courses before moving forward.
Submitting a new agent into Virtuoso Marketplace
When ready with a Virtuoso Composer agent idea, you’ll first build the agent. When happy with the agent, you’ll then have the option to submit it to the Virtuoso Marketplace.
To create then submit a new agent
Log into Virtuoso.ai using one of the available login options
The Virtuoso Marketplace dashboard will appear, click the Create Agent button
The Create New Agent screen appears. Populate the form field.
Name: The name of your agent. This will appear in Virtuoso Marketplace searches.
For example, if your agent will approve invoice registers based on specific logic, you might call your agent “Invoice Approver”.Short Description: A brief description, up to 100 characters, of what the agent will do. This description will appear in the Virtuoso Marketplace search, before a user drills down into the agent for more information.
Full Description: A detailed description of the agent and what it’s use is. Use this space to convince would-be customers to use your agents versus other similar ones. This description will appear on the agent detail screen.
Logo: The image that appears on the agent summary and detail screens. If left blank, we’ll automatically populate it with a default image.
Agent Framework: Currently only available as a selection of Flowise, but other options, such as n8n and LangChain will be available in the future.
Click Create Agent after all fields are populated.
The Agent Created Successfully modal appears. To start building the agent logic through the specified agent framework, select Start Building in Composer.
If you’d prefer to start the remaining agent details, select Review Agent Details.
The Composer flow user interface to build the agent will appear.
Complete the build and validate the agent then click Save in the top right corner.
When ready, click the My Agents top-menu option, then select the agent to complete the setup and submission process.
On the right side of the agent screen, click Edit.
Make final edits in the Agent Details and Badges & Tags section. Additionally, within the Badges & Tags section, ensure you’ve selected all relevant badge categories. These badges will be used by users when filtering to find agents on the marketplace.
Save your changes.
When ready to submit, select the Submit for Review button under Version History.
IMPORTANT: Ensure you’re selecting the most recent version with the latest changes you wish to make available to users.
The Submit for Review - Agent Version Details pop-up appears.
Review to ensure all fields are populated. If any edits are required, you may leave the screen to make the edits or select the Edit Details button on top of the screen. In either case, ensure the below, version specific, required fields are complete.
What’s New: Typically used to show what’s new between versions for the user determining what agents to download. For new agents input something indicating this is the first release.
Agent Demonstration Video: A video showing the agent flow working with commentary explaining how it works. This is used by Yardi during the review process.
Agent Use Case Document: A document explaining the scenario(s) for the agent’s use and how it benefits users. This is used by Yardi during the review process.
To submit the iteration of the agent to the marketplace for review, click Submit for Review.
NOTE: If you leave the Composer agent user interface and need to get back prior to submitting a version, you may do so by navigating back to the agent screen and clicking the Composer button, under Actions.
Once submitted, what’s next?
Upon submission of the agent, the agent status will change from In Development to Submitted to Review. Yardi will review the submission and communicate through email as the agent progresses through the approval process.
Typically, the review process may take up to 2 weeks, sometimes longer.
Evaluation Criteria
Yardi takes the following into consideration when reviewing agent submissions.
Functionality: Does the agent run as expected?
Reusability: Can this be reused across clients with config tweaks?
Innovation: Did they use multiple MCP servers or logic branches?
Documentation: Did they submit a clean overall package?
After a successful submission
When the agent is approved, it will change to a Published state and appear on the Virtuoso Marketplace for companies to integrate to their Yardi software. Additionally, you’ll receive a notification that your submission was successful.
After an unsuccessful submission
If the agent needs work, or Yardi deems the agent use case improper, you’ll receive an email stating the reason for the failed submission and the agent status will update to:
Returned to Developer if the agent or submission requires some work.
ORRejected if Yardi deems the agent improper.
Updating and submitting an agent version update
As with any software solution, updates are often required after the first iteration is made available. Fortunately, adding new versions to an existing agent is easy and generally follows the same steps.
To add and submit a new version of an agent
On the top menu, click the My Agents option.
On the bottom of the agent screen, click New Version.
The Add New Version pop-up appears with a new version number.
Populate the required fields, including What’s New and how you want to populate the Composer flow.
Start from Scratch: Start with a new Composer flow with no prior history included.
Previous Version: Start with a prior version’s Composer flow and retain or edit it in a later step.
Import JSON: Import a local JSON file that will build a new Composer flow from a previously exported flow.
Click Create Version. The version will now appear under the Version History section of your agent page.
To make additional edits to the Composer flow, click Composer under the Actions column in Version History.
When ready to submit for marketplace publishing review, click the Submit for review button as you did when releasing prior iterations of the agent.