In QuickSilver, agents are AI assistants that creators can configure, power with APIs, and optionally monetize. Once created, these agents can be published to QuickSilver, where other users can interact with them through chat—either globally or directly. This guide walks you through creating your first agent, defining its behavior, connecting it to APIs, and preparing it for publication on the QuickSilver network.

​
Developer Tip

You can also access your agent programmatically via the QuickSilver API, making it easy to integrate your agent into your own apps, bots, or backend systems.

​
Step 1 — Sign in

Before you begin, log in to your Quicksilver account:

​
Step 2 – Create a New Agent

  1. From the left panel, navigate to your projects dashboard: https://qs.iotex.ai/projects
  2. Click the ”+ New Project” button
  1. Fill in your Agent’s basic information:
  • Name – Chose a clear and descriptive name for your agent
  • Description – Describe what the Agent can do
  • System Prompt – Define your Agent’s functional boundaries and expected behavior: define this prompt carefully as it will define how your Agent responds to user queries.
  • Example Questions: include some example questions that a user would want to ask to this agent
  • Tags: include tags to help users find this Agent when they search for specific features
  • README: include any additional documentation in the Readme.md file
Example Agent Creation Details

​
Step 2 – Add an API Schema

  1. After creating the Agent, you can also access it from your Projects Dashboard.
  2. Open the Agent details page:
  3. Scroll down the details page and click on “Add Schema” to start defining the APIs your Agent will use:
  4. Start from providing the API schema basic details:
  • Schema Name: A clear name for this API, will help identifying this API in your dashboard
  • Description: A description of the API
  • API endpoint: the API server endpoint
  1. Next, define the API schema by providing the OpenAPI or curl specification:
  • Ensure you include descriptions for each endpoint and its input/outputs for better results when the Agent decides which endpoint to use when replying to user queries:

​
Step 3 — Publish your Agent

Once your Agent is ready, you can use the Publish button in the top right of the Agent’s page to publish/unpublish the Agent to Quicksilver:
Tip: Preview and test your agent before publishing to ensure quality.
  • Set guardrails in the Agent’s System Prompt to restrict or allow certain topics or actions.
  • Testing: Use the Agent’s chat to preview how the agent handles real queries.
Your Agent is Now Live!
  • It will appear on the Quicksilver portal.
  • Users can engage with it via:
    • The Global Entry (shared chat box on the home page)
    • Direct Selection (agent-specific chat window)