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
- Choose a template or start from scratch
- Define your agent's personality and purpose
- Configure conversation flow and responses
- Test your agent in the playground
- 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
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