> For the complete documentation index, see [llms.txt](https://docs.opendialog.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.opendialog.ai/getting-started-1/quick-start-ai-agents/the-start-from-scratch-ai-agent/welcome-conversation.md).

# Welcome Conversation

<figure><img src="/files/MkfrcBhDh6AfWbfKJuag" alt=""><figcaption><p>Welcome Conversation</p></figcaption></figure>

Users are directed to the Welcome Conversation from the Chat Management conversation, and then the Conversation Engine will select the Welcome Scene as it is the only *Starting* scene (as indicated by the green dot).

<figure><img src="/files/VlPzzaJaWaNda1yusOdY" alt=""><figcaption><p>Welcome Scene</p></figcaption></figure>

The Welcome Scene has just one *Starting* Turn - the Welcome Turn - with an APP message that will send an appropriate Welcome Message for the user.

<figure><img src="/files/GtT1WbOm9BGjnvGo6NwP" alt=""><figcaption><p>Welcome Turn</p></figcaption></figure>

The WelcomeResponse Message is a static message - you can customise it by editing it directly or turn it into a dynamic message by using an LLM action on the intent to generate a relevant welcome message.

<figure><img src="/files/GObgWN9vKrtGrGcZip3t" alt=""><figcaption></figcaption></figure>

If you visit the Preview section of the bot (under Test) you will see this message appear in WebChat. The `intent.core.welcome` intent was the incoming user intent (triggered automatically by the fact that WebChat loaded on the page). That intent (containted in the Chat Management conversation) then transitions the context to the Welcome Conversation where the OpenDialog Engine identified one possible response - the `WelcomeResponse` - which the associated message.

<figure><img src="/files/D550y7BedxV8zg3K860H" alt=""><figcaption></figcaption></figure>

The WelcomeResponse intent then transitions us to the Topic Conversation where we are waiting for a message from the user. You can see the transition under "Transition to" in the WelcomeResponse intent.

<figure><img src="/files/ezs4Z24uYI02zcAMAl7J" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.opendialog.ai/getting-started-1/quick-start-ai-agents/the-start-from-scratch-ai-agent/welcome-conversation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
