Prerequisites
- Configure an LLM in Project resources.
Set up an agent with a Webchat endpoint
Create project
- On Cognigy’s main page, click
in the projects bar. - In the New project dialog, enter a name for the project and click Start empty.
Create agent
- On the Agents page, click + Create agent.
- On the Agent configuration tab, configure the following:
- Name — enter a unique name, for example,
Cognigy Starter. - Job — enter a job description, for example,
Cognigy advisor. - Instructions — enter relevant instructions for the agent to carry out their tasks, for example,
You are responsible for answering questions and help users regarding any doubts to Cognigy. - LLM — select an LLM.
- Name — enter a unique name, for example,
- Click Save.
- Go to the Skills tab and click + Create skill.
- On the Create skill page, configure the following:
- Skill Name — enter
tech-support. - Description — enter
Retrieves information from Cognigy docs. - Instructions — enter
Invoke this skill when the user sends "I need technical support". Say "Sure, I'll help with some information from the docs". Use search_cognigy_documentation to help the user with their queries.
- Skill Name — enter
- In the Tools section, click + Add tool and select
search_cognigy_documentation.
Create endpoint
- In the navigation menu of your project, go to Deploy > Endpoints.
- On the Endpoints page, click + New endpoint.
- In the New endpoint dialog, select Webchat v3 and click Create endpoint.
- On the Setup tab, configure the following:
- Endpoint name — enter a unique name, for example,
Cognigy Webchat. - Target — select the agent you previously created.
- Endpoint name — enter a unique name, for example,
- Click Save.
Customize Webchat
To customize settings within the Webchat endpoint, follow these steps:- Click the preview bar on the right with the
icon. The live preview section opens. In this section, you can see the changes you make to the layout in real time. - On the Layout tab, go to the Home screen section and enter
Welcome Cognigy User! How can we help you?in the Welcome text field. - In the Conversation starters section, turn on Activate conversation starters and click + Create conversation starter.
- In the Starter 1 section, configure the following:
- Title — enter
Who are Cognigy? - Type — select Open a URL.
- URL — enter
https://www.cognigy.com/.
- Title — enter
- Create other conversation starters:
Starter 2:
- Title — enter
Cognigy Blog. - Type — select Open a URL.
- URL — enter
https://www.cognigy.com/blog. Starter 3: - Title — enter
I need technical support. - Type — select Send a postback payload. With this type, the user immediately starts a conversation with the agent.
- Payload — enter
technical-support.
- Title — enter
- Click the Behavior tab, go to the Chat options section and turn on Activate chat options.
- In the Conversation rating section, select After every reply from the Activate conversation rating list.
- Click Save.
Test agent
To test your agent using Demo Webchat, follow these steps:- In the live preview section, click I need technical support to start a conversation with the agent.

- The agent responds with
Sure, I'll help with some information from the docsas instructed.
- Send the following message to the agent:
How do I customize Webchat? - The agent searches the docs and sends you the answer, which contains information about how to customize your Webchat widget.
- After receiving the agent’s reply, click
. - On the Chat options screen, click
(thumbs up) and leave the messageI appreciate the quick responsein the feedback field. Click Send feedback.
- After you submit feedback, a notification appears at the top of the window. Users can give feedback an unlimited number of times. To return to the conversation you started or view earlier conversations on the home screen, click the < button in the upper-left corner of the screen.
