Skip to main content

Overview: Getting Started with ai12z

This walks you through the process step by step—from creating an account to deploying a fully functional AI assistant. By following these steps, you’ll be able to integrate your agent into your digital ecosystem, train it with your unique content, and ensure it delivers accurate and valuable insights to your users.

With the flexibility to connect external systems, customize responses, and utilize advanced tools like the ReAct model, your agent will be a dynamic and powerful solution designed to grow alongside your business. Let’s get started!

1. Sign Up and Create Your Account​

  • Why This Matters: Creating an account is your entry point into the GenAI platform. It provides you access to all the tools and settings needed to build your agent.
  • Detailed Steps:
    • Visit the ai12z website
    • Click the Try ai12z button prominently displayed on the homepage. To create a free account without any credit card
    • Fill out the required details:
      • Name: Your full name or your organization’s representative.
      • Email Address: Ensure it’s valid and accessible for verification.
      • Password: Create a secure password following the platform’s guidelines.
      • Organization Details: If applicable, provide company name, size, or industry.
    • Verify your email by clicking the link sent to your inbox.
    • Log in using your new credentials.
  • Outcome: You gain access to the platform’s dashboard and can begin setting up your agent.

Complete guide for Creating an Account

2. Define Your GenAI Agent’s Use Case​

  • Why This Matters: A well-defined use case helps focus the agent’s design, ensuring it meets the specific needs of your organization or audience. ai12z uses AI to create System prompts based on this information
  • Detailed Steps:
    • Identify your primary goals:
      • Do you want the agent to answer customer inquiries, assist in workflows, or provide e-commerce recommendations?
      • Is it internal (employees) or external (customers)?
    • Consider the type of interaction:
      • Bot, Search Control, Search Result, or a Knowledge box
      • HTML widgets (examples: Morgage Calculator, Google Chart), Carousels: Lists & Sliders
      • Support of Voice commands (speech-to-text and text to speech).
      • Ability for user to upload an image and ask questions
      • Define your Calls to Actions (CTA).
      • Define your goals
    • Type of agent
      • Retrieval-Augmented Generation (RAG) only solution is outdated. When comparing solutions ensure the vendor supports ReAct and not RAG only.
      • Modern GenAI Agents are based on Reasoning and Acting (ReAct) with Integrations, Forms, HTML widgets. Where RAG is one of the Integrations
        • Out of the box Inegrations, email, sms, Salesforce, Jira, Google Maps..
        • Custom Integrations integration with your own backend services or others
        • MPC client, ai12z can integrate with thousands of external systems
    • Draft a simple mission statement:
      • Example: "Our agent will help customers find product information quickly while suggesting relevant accessories."
  • Outcome: A clear roadmap that aligns with your business goals and user expectations.

3. Create an Agent​

  • Why This Matters: an Agent serves as the container for all the configurations, data, and settings specific to an Agent.
  • Detailed Steps:
    • Log in to your account and access the "Agents" section.
    • Click "Create New Agent" and provide the following:
      • Name: Something descriptive like "Customer Support Assistant."
      • Organizatin: The Organizatin for who this agent is for
      • URL of Organization: The Organizatins public website
      • Purpose: A brief summary of the Agent’s purpose.
      • Language: Select if content being ingested is not english
    • Save and proceed to the next step.
  • Outcome: A dedicated space for building and testing your agent. Using the correct Organizatin information will be used to populate the System prompts

Complete guide for Agent Creation

4. Add Content for Contextual Understanding​

  • Why This Matters: The quality of the responses depends on the data available. Relevant and structured content ensures the agent generates accurate, useful answers.
  • Detailed Steps:
    • Website Content:
      • Add your website URL for sitemap ingestion or content crawling.
      • Configure settings to limit ingestion to specific pages or sections.
      • Complete guide to Add a Website
    • Knowledge Base Articles:
      • Navigate to the content upload section.
      • Select "Knowledge Base" and upload or manually enter articles.
      • Use tags and categories for better organization.
      • Complete guide to Add a Knowledge Base Article
    • PDF Documents:
      • Drag and drop important PDF files or browse to upload.
      • Ensure the PDFs are OCR-enabled for easy text extraction.
      • Complete guide to Add a PDF document
    • Advanced Options:
      • Connect directly to your CMS using built-in connectors for real-time updates, as well as other connectors such as Sharepoint.
  • Outcome: A comprehensive repository of your organization's content.

5. Test Asking Questions​

  • Why This Matters: Testing ensures the agent understands queries and delivers accurate responses, validating its utility before deployment. After creating an Agent and adding some content. Do your first test, it is that easy.
  • Detailed Steps:
    • Go to the “Test Drive”
    • How to test drive your AI Website Assistant
    • Input various sample questions that mimic real-world user queries.
      • Example: "What are your return policies?" or "How can I schedule a demo?"
    • Evaluate:
      • Relevance of the answers.
      • Response time.
      • Coverage of the content.
    • Refine:
      • If answers are incorrect, adjust content, retrain, or tweak prompts.
  • Outcome: A validated and reliable agent capable of addressing user needs.

6. Create Brand Guidelines (AI Brand Info)​

  • Why This Matters: Consistent branding increases user trust and ensures every web control (Bot, Search, Knowledge Box) matches your visual identity. Using AI Brand Creation saves time by auto‑generating colors, typography, tone, and structured brand JSON from just a few images.
  • Detailed Steps:
    1. Go to AI Settings → Brand Guidelines.
    2. Click Generate Brand.
    3. Upload 2–5 brand images (homepage, logo, UI elements, marketing graphic).
    4. Click Generate Brand to start AI analysis (30–60s).
    5. Review the populated fields: brand name, colors, typography, tone, imagery, iconography, logo usage JSON.
    6. Adjust any field manually if needed (e.g., refine tagline or primary color).
    7. Click Save Brand Guidelines.
  • Outcome: A saved brand profile the platform can reuse for theme generation and future control configuration.

Complete guide: AI Brand Creation

  • Why This Matters: A bot configuration links your agent to an actual user interface. You can create multiple configurations (e.g., Default, Support, Sales) with different themes and welcome experiences.
  • Detailed Steps:
    1. Open your Agent, select Controls → Bot.
    2. Click Create Configuration (or edit an existing one).
    3. Provide:
      • Name (e.g., “Default” or “Sales Assistant”).
      • Description (purpose—internal note only).
    4. Select an initial Theme (see next section for Custom themes).
    5. (Optional) Adjust Display tab: expanded on load, width/height.
    6. (Optional) Set Settings tab fields (Bot Title / avatar / logo).
    7. Open Info tab to prepare Welcome & Privacy content (see Section 9 below after theming & deployment).
  • Outcome: A reusable configuration representing how this agent appears and behaves in the UI.

Reference: Bot Configuration

8. Select or Generate a Theme​

  • Why This Matters: Themes control visual consistency (colors, gradients, typography). If you generated Brand Guidelines (Step 6), selecting Custom lets the system auto‑build a matching theme—no manual palette tweaking required.
  • Detailed Steps:
    1. In the Bot Configuration, open the Theme dropdown.
    2. Choose:
      • Default Theme: Prebuilt standard palette.
      • Custom: Uses saved Brand Guidelines to auto‑generate tokens (primary / secondary / accent colors, font family, tone alignment). If no guidelines exist yet, a blank customizable template is created.
    3. Save the configuration after selecting Custom to apply generated variables.
    4. (Optional) Open Style tab to add advanced overrides (CSS variables, background, gradients). Prefer variables over deep selectors for forward compatibility.
  • Outcome: A theme-aligned control with minimal manual styling effort.

Tip: Generate Brand Guidelines before choosing Custom for best results.

9. Create the Welcome & Privacy Experience​

  • Why This Matters: The Welcome Message sets initial tone and drives user engagement (button prompts, quick question suggestions). A clear Privacy Statement builds trust and transparency.
  • Detailed Steps:
    1. In the Bot Configuration, go to the Info tab.
    2. Author or paste your Welcome Message (HTML allowed: buttons, structured layout, branded headings).
    3. (Optional) Use AI Create Welcome Page (Generate Welcome) to auto-build HTML + suggested questions based on your domain and content.
    4. Add quick action buttons that call ai12zBot.sendMessage('Your prompt').
    5. Add a concise Privacy Statement with a link to your full policy.
    6. Preview, then Save.
  • Outcome: A polished first-interaction flow that increases relevance and click-through.

Reference sections: Welcome & Privacy in Bot Configuration

10. Deploy Web Controls to a Web Page​

  • Why This Matters: Deployment makes your agent usable by real users and provides live feedback to refine content and prompts.
  • Detailed Steps:
    1. Navigate to Web Controls. Web Controls
    2. Copy the embed snippet for the Bot (or Search / Knowledge Box).
    3. Paste before the closing </body> tag of your site (staging first recommended).
    4. Confirm the script loads (no 404 network errors) and the element renders.
    5. Test initial load + welcome message + a few question flows.
    6. (Optional) Add CSP headers for production (allow ai12z CDN domains).
  • Outcome: A live interactive control ready for user sessions.

11. Categorize Content​

  • Why This Matters: Categories improve the organization of content, making the agent more efficient at retrieving relevant data.
  • Detailed Steps:
    • Auto generate categories based on your content and the purpose of the agent:
      • Business functions (e.g., Sales, Support, FAQs).
      • Content type (e.g., Technical Documents, Tutorials).
    • Assign categories to uploaded content manually or use automatic tagging.
    • Test categorization by enabling "Category Filter" in the Test Drive section.
    • Adjust relevance scores to control how strict the filtering is.
  • Outcome: Users receive more focused and relevant responses.

12. Enhancing ReAct - Reasoning and Acting​

  • Why This Matters: ReAct allows your agent to combine reasoning with action, making it more versatile and capable. That is the ReAct LLM knows about all the out of the box agents, custom agents and Forms available to use as a tool to accomplish an Action. The reasoning engine has the history of everything it has done for this sessione.
  • Detailed Steps:
    • ReAct System Promt, is created when creating an Agent, the properties of the Agent Creation dialog, specifically the agent purpose, the Organization name and the Organization URL are used to first create Pgent Organization Information. Next from this information the AI creates all the prompts.
    • Customize the system prompt:
      • AI creates the system prompt. You should update for your particular use case, for example to add Calls To Actions.
    • Enable necessary agents/tools for your agent
    • Understanding the workflow
    • Add Custom Integrations
  • Outcome: An intelligent agent capable of not just answering but acting on queries.

13. Set Up Forms​

  • Why This Matters: Forms allow you to collect structured data, which is essential for workflows like lead generation or service requests.
  • Detailed Steps:
    • Use the form builder to design custom forms.
    • Add dynamic controls like dropdowns or date pickers linked to APIs.
    • Integrate forms into the web control for seamless interaction.
    • Optional see how to create a form dynamically as a custom agent
  • Outcome: A richer, more interactive user experience.

14. Set Up Image AI​

  • Why This Matters: Image AI adds visual context to your agent, enhancing user interactions with relevant images and descriptions.

  • Detailed Steps:

    • Enable "Image Match AI" When answer is created, it will attempt to match an image to the Answer
    • Enable "Image Description AI" When content is ingested, Vision AI will analyze the image, page content and alt text and recreate the alt text.
    • Select image quality (Low, Auto, High) based on your needs.
    • Complete Guide for Setting Up Image AI

  • Outcome: an Agent experience enriched with text and images for more engaging interactions.

15. Test, Monitor, and Optimize​

  • Why This Matters: Continuous testing and optimization ensure the agent remains effective as user needs evolve.
  • Detailed Steps:
    • Use analytics to monitor user interactions.
    • Review Data tab, - see questions asked, user feedback to identify areas of improvement.
    • Review logs - Validate that the workflow is what is expected.
    • Regularly update content, categories, and configurations.
  • Outcome: A continuously improving agent that meets user expectations.

16. Create Custom Integrations​

  • Why This Matters: Custom Integrations let you connect to your digital systems, giving the agent context, also enables client user controls such as Carousel slider or list, Template HTML widgets, even the ability to process source data with Python.
  • Detailed Steps:
    • Create a Custom Integrations - Name and Description, so the LLM knows when to call it.
    • Select Data Source: None, RestAPI, GraphQL, MCP
    • Create the LLM parameters
    • Test the endpoint in the Agent
    • Select how to Handle the data response: Send to the LLM, or send the client with a template to visualize the data, such as a Carousel or Template (HTML widget) or Form
    • Ability to use JSONata, both for posting data to an endpoint, and filterting data from a source
    • Enable applying Custom Python code to process data
  • Outcome:

By breaking down each step into detailed actions, you ensure a clear understanding of the process, reducing errors and streamlining implementation.