YNIK™

Documentation

Learn how to build, deploy, and manage intelligent AI agents with YNIK

Getting Started

Welcome to YNIK! This guide will help you create your first AI agent in minutes. No coding required - just your creativity and purpose.

Quick Start

  1. Choose a template or start from scratch
  2. Define your agent's personality and purpose
  3. Configure conversation flow and responses
  4. Test your agent in the playground
  5. Deploy and share with your team or the world

💡 Pro Tip: Start with a template that matches your use case. You can always customize it later to fit your specific needs.

Creating Your First Agent

1. Choose Your Starting Point

You have two options when creating a new agent:

  • Template: Start with a pre-built agent for common use cases
  • Blank Canvas: Build completely custom agent from scratch

2. Define Core Purpose

Every great agent starts with a clear purpose. Ask yourself:

  • What problem does this agent solve?
  • Who is the target audience?
  • What actions should users take after talking to it?
  • What tone and personality fits best?

Personality Configuration

YNIK agents aren't just chatbots - they're personalities with purpose. To create an engaging conversational experience, you'll need to figure out these 6 essential elements:

🎯 Purpose

What problem does your agent solve? What's the end goal?

👤 Role

Who is your agent? Expert, coach, assistant, friend?

💬 Response

How does your agent structure conversations and answers?

🗣️ Voice

What tone and personality shine through in every message?

✨ Interjections

Catchphrases and expressions that make your agent unique

📋 Steps

The process or methodology your agent follows

Example Configuration

Purpose: Help figure skaters improve their technique and overcome mental blocks

Role: Former Olympic figure skating coach with 20+ years experience

Response: Ask about current skill level, identify specific challenges, provide step-by-step guidance

Voice: Encouraging but direct, tough love approach, believes in pushing limits

Interjections: "You can do this!", "Don't hold back!", "Push yourself!", "Feel the ice!"

Steps: 1) Assess current ability, 2) Warm up with basics, 3) Practice targeted moves, 4) Focus on form and technique, 5) Build confidence through repetition

These simple building blocks will build the foundation for your agent's personality and purpose. More nuance will emerge as you push further, but these ideas wil get you started. The authoring experience will guide you through configuring these elements in detail.

Available Templates

Start fast with our curated collection of agent templates:

📊 Market Intelligence

Expert on competitors and industry trends

📝 Intake Wizard

Onboarding with smart questions

🎨 Creative Kickoff

Overcome creative blocks and find direction

🗣️ Conversation Prep

Practice difficult conversations

Try a Template →

Deployment Options

Once your agent is ready, you have several deployment options:

🌐 Public Link

Share a direct link that anyone can use to chat with your agent

🔒 Private Access

Restrict access to your team or specific users with authentication

🔌 Website Embed

Embed your agent into websites, apps, or other systems super easy.

📦 Custom UI

Completely control the UI, but let us do all the plumbing.

Integration Methods

Integrate YNIK agents into your website or application with these simple methods:

🔗 1. Snippet Embed Method

The easiest way to add a chatbot to any website. Just include our JavaScript file and it automatically injects the chatbot interface.

Basic Implementation

<!-- Add this before closing </body> tag -->
<script src="https://cdn.yeahnoiknow.com/ynik-embed.js" 
        data-agent-id="your-agent-id"
        data-position="bottom-right"
        data-theme="dark"></script>

Configuration Options

data-agent-id

Your unique agent identifier

data-position

bottom-right, bottom-left, top-right, top-left

data-theme

dark, light, auto

data-trigger-text

Custom button text (default: "Chat")

✨ That's it! The chatbot will automatically appear on your site with a floating button that opens the chat interface.

🎨 2. Custom UI Method

Build your own chat interface while YNIK handles all the backend logic. Use data-ynik attributes to identify elements.

HTML Template

<!-- Chat Container -->
<div class="max-w-md mx-auto bg-gray-900 rounded-lg shadow-xl" 
     data-ynik="container" 
     data-agent-id="your-agent-id">
  
  <!-- Messages Area -->
  <div class="h-96 overflow-y-auto p-4 space-y-3" 
       data-ynik="messages"
       data-ynik-first="Hello! I'm here to help. What can I assist you with today?">
    <!-- Messages will be injected here -->
  </div>

  <!-- Input Area -->
  <div class="border-t border-gray-700 p-4" 
       data-ynik="input-area">
    <div class="flex space-x-2">
      <input type="text" 
             class="flex-1 px-3 py-2 border border-gray-600 rounded-lg bg-gray-800 text-white" 
             data-ynik="input" 
             placeholder="Type your message...">
      <button class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700" 
              data-ynik="send-button">
        Send
      </button>
    </div>
  </div>
</div>

Message Bubble Templates

<!-- User Message Template -->
<div class="flex justify-end" data-ynik="user-message">
  <div class="bg-blue-600 text-white px-4 py-2 rounded-lg max-w-xs" 
       data-ynik="user-bubble">
    <!-- User message content -->
  </div>
</div>

<!-- Bot Message Template -->
<div class="flex justify-start" data-ynik="bot-message">
  <div class="bg-gray-700 text-white px-4 py-2 rounded-lg max-w-xs" 
       data-ynik="bot-bubble">
    <!-- Bot message content -->
  </div>
</div>

Initialize Custom UI

<script src="https://cdn.yeahnoiknow.com/ynik-custom.js"></script>
<script>
  // Initialize YNIK with your custom UI
  YNIK.init({
    agentId: 'your-agent-id',
    customUI: true,
    onReady: function() {
      console.log('YNIK agent ready!');
    },
    onMessage: function(message, isUser) {
      console.log('New message:', message);
    }
  });
</script>

Required Data Attributes

data-ynik="container"

Main chat container

data-ynik="messages"

Messages scroll area

data-ynik="input"

Text input field

data-ynik="send-button"

Send message button

data-ynik="user-bubble"

User message template

data-ynik="bot-bubble"

Bot message template

🎨 Full Control: Style everything with your own CSS classes while YNIK handles the conversation logic, message routing, and agent responses.

Which Method Should I Use?

Snippet Embed
  • ✅ Fastest setup (1 line of code)
  • ✅ Automatic updates
  • ✅ Mobile responsive
  • ⚠️ Limited customization
Custom UI
  • ✅ Complete design control
  • ✅ Brand consistency
  • ✅ Custom layouts
  • ⚠️ More development time

Troubleshooting

Agent Not Responding

  • Check bot settings
  • Check the browser console for helpful messages
  • Review steps and conversation flow configs

Unexpected Responses

  • Review personality configuration settings
  • Check for conflicting instructions
  • Test with different conversation starters

Performance Issues

  • Monitor token usage and rate limits
  • Optimize prompt length, reduce words
  • Consider using search instead of instructions

Need More Help?

Can't find what you're looking for? Our support team is here to help.

Contact Support