Swiftask
  • Quick start
  • Key concepts
    • AI Tools Hub
    • Agents
    • Knowledge base
    • Skills
    • Projects
    • Automation
  • AI tools hub
    • Introduction
    • Chat interface
    • Tokens
    • List of AI features
    • AI suggestions
    • FAQ
  • Agents
    • Introduction
    • Create an agent step by step
    • How to evaluate your agent
    • Multi-agents
    • Widget
    • Share agent
    • FAQ
  • Knowledge base
    • Introduction
    • Data connectors
      • Rich text
      • PDF File
      • Azure Document Loader
      • YouTube
      • Apify Dataset
      • PowerPoint File
      • Excel File
      • DOCX File
      • SQL Database
      • REST API
      • JSON File
      • CSV File
      • SQL Database Query
      • Website
      • Webpage
      • Sitemap
      • Dropbox files
      • Google drive files
    • Create a knowledge base
    • Attach Knowledge base to your agent
    • Share knowledge base
    • FAQ
  • Skills
    • Introduction
    • Skills library
      • Webpage Content Parsing
      • GitLab File Creation
      • Browsing with Perplexity
      • Open API
      • Retriever data from external sources
      • GitHub pull request diff retriever
      • GitHub pull request comment
      • Export table to Excel
      • Export text to PDF
      • GitHub file content
      • GitHub pull request info
      • OpenDataSoft
      • Agent as Skill
      • Swiftask AI recommandation
      • LinkedIn Share
      • Prismic migration create
      • Github create file
    • Create a new skill
    • Attach skill to your agent
    • FAQ
  • Projects
    • Introduction
    • Create a project
    • Generate task
    • Task AI chat
    • Project agent
    • FAQ
  • Automation
    • Introduction
    • Create an automation
  • Workspace admin
    • Introduction
    • Invite collaborators to join your workspace
    • Subscription renewal and Credit explanation
    • Purchase credits
    • Referral
    • Subscription plan & token distribution
    • Cancel subscription /Manage payment method
    • Personnal data security
    • SSO For enterprise
  • Use cases & Tutorials
    • Chat with multi-AI
    • Chat with PDF file
    • Import data - Webpage
    • How to generate an image on Swiftask
    • Import data (Azure Document Loader) - PDF
    • How to generate videos on Swiftask
    • Transform your ideas into videos with LUMA AI
    • Upgrade subscription plan
    • How to create an agent? step by step
    • Create AI agents for your business
    • Integrate external API in your agent
    • Create a professional landing page in 5 minutes
    • How to automate your blog content creation with an AI agent
    • How to evaluate your AI agent
    • How to create a Community Manager agent
  • Developer
    • List of AI and agents accessible via API
    • Access AI and agent through API
    • OpenAI SDK
  • Support & Social network
  • Changelog
    • May 29, 2025 - Enhanced Voice Input & AI Transcription
    • May 25, 2025 - Enhanced AI Models & Improved User Experience
    • May 25, 2025 - Mistral Medium 3 & Small 3 Integration
    • May 19, 2025 - Audio Recording Interface Improvements
    • May 19, 2025 - Third-Party Authentication Management
    • May 17, 2025- Enhanced Google Drive Synchronization & Privacy Improvements
Powered by GitBook
On this page
  1. Agents

Widget

PreviousMulti-agentsNextShare agent

Last updated 13 days ago

The widget is an agent that you can integrate into your website or e-commerce, acting as an informant and a customer service available 24/7. Swiftask makes it easy to create this widget, even if you have no programming skills. Integrating the agent into your site is easy thanks to the links provided during the creation of your agent.

1

Go to the "Agents" section

2

Click on "Create an agent."

3

Give your agent a name.

4

Select an Agent template.

  • Choose Blank template if you want to customize manually your agent.

  • Confirm with "Create Agent" to generate the basic environment.

5

Agent profile

  • Integrate the visual identity by importing the agent's official logo.

  • Clearly define the functional scope in the agent's "description".

  • Select an appropriate "LLM model" that meets the required security and performance standards.

6

Agent instruction

  • Configure the main "instructions" with explicit control parameters.

  • Implement complementary "skills" to expand the agent's functionalities.

  • Check the category to find the skill you need. If it's not available among the ready-to-use skills, create a new one.

  • Attach verified "data" if operations require documentary references.

✅ Data plays a fundamental role by providing the AI agent with a customized knowledge base. This feature, called "knowledge base," enhances the agent's capabilities by giving it access to specific information that is not part of its initial training.

  • Activate the "Long Term Memory" function to ensure continuity of interactions while adhering to data retention policies. This feature enables AI agents to remember past conversations with users, delivering more personalized and contextually relevant responses across multiple sessions.

7

More options

This is the section where the agent can be transformed into a widget. A Swiftask widget is an AI agent that can be embedded on your website, acting as a 24/7 customer service representative, responding to visitors according to your customized instructions.

What parameters can be adjusted?

  1. Activation and deactivation of the widget on the site

  2. Limitation of the number of messages

  3. Authorization for file sending

  4. Insertion of the Chatbot name

  5. Placement of the subtitle to display

  6. Entry of the placeholder

  7. Registration of the welcome message

  8. Choice of the chatbot avatar

  9. Selection of the chatbot interface color

  10. Preference on the shape of the chatbot icon

  11. Widget positioning: left or right

  12. Brand hiding

  13. Default opening

  14. Welcome message

  15. Startup questionnaires

  16. Handling of the no-code integration code

8

Widget Inbox

The Widget Inbox centralizes all user conversations with your AI agents. It provides:

  • Chronological list of all user discussions

  • Conversation details (date, time, duration, message count)

  • Quick identification of friction points and common questions

  • Filtering options by date, status, keywords, and user satisfaction

  • Search functionality for specific conversations

9

Evaluations are used to test and validate the performance of your AI agent before deployment.

This functionality is essential for several reasons:

  • Verifying the quality of responses: It allows you to test how your agent responds to different questions or scenarios to ensure that it provides accurate and relevant information.

  • Identifying weaknesses: By testing your agent with various queries, you can pinpoint areas where it lacks knowledge or responds inappropriately.

  • Optimizing instructions: The results of evaluations help you refine your agent’s instructions and parameters to enhance its performance.

  • Validation before deployment: This step ensures that your agent is ready to interact with real users and accurately represents your brand or service.

  • Comparing versions: You can assess different configurations of your agent to determine which one best meets your specific needs.

10

Switch to Developer section and Copy/Pate the link to embed your widget in your website

Even without any programming knowledge, you can easily integrate your agent into your website as a widget. To do this, once your agent is configured, go to the "Developer" section where you will find the codes to copy and paste onto your site.

Detailed Explanation

  1. Agent Client Token

  2. Purpose: This token is a unique identifier for your agent. It is used for authentication purposes when making requests to Swiftask's backend services.

  3. Usage: Ensure that this token is kept secure, as it grants access to your agent's functionalities.

  4. Example: "23521f93-7487-496b-9dac-bc9db0e69cae"

  5. Agent Slug

  6. Purpose: The slug is a user-friendly identifier for your agent, typically used in URLs and API calls. It should be unique within the Swiftask ecosystem.

  7. Usage: This slug can be referenced when embedding the agent in your website or when making API requests.

  8. Example: "documentation-agentik3cc"

  9. Widget Integration: Integration code to add the widget to your website.

  10. Iframe Integration: Code to embed the agent in an iframe.

  11. API Integration: It allows developers to interact with Swiftask agents programmatically using the provided client token and endpoint, enabling custom implementations that go beyond the standard widget or iframe options through RESTful API calls.

11

Background logs

In the background logs, you have the ability to see processes running in the background. These logs can be particularly useful for debugging and monitoring agent performance.

12

To change other settings, go to Advanced Settings:

  • Conversation Starters : Customize the beginning of the conversation to provide a tailored welcome.

  • Temperature : Adjusts the bot’s creativity: high values result in varied but unpredictable responses, while low values produce more consistent responses.

  • Top K chunk : Defines how many parts of documents the system retrieves from the indexed ones. This helps limit the number of results and speeds up the search.