diff --git a/daprdocs/content/en/getting-started/quickstarts/conversation-quickstart.md b/daprdocs/content/en/getting-started/quickstarts/conversation-quickstart.md new file mode 100644 index 000000000..b9656fa14 --- /dev/null +++ b/daprdocs/content/en/getting-started/quickstarts/conversation-quickstart.md @@ -0,0 +1,151 @@ +--- +type: docs +title: "Quickstart: Conversation" +linkTitle: Conversation +weight: 90 +description: Get started with the Dapr conversation building block +--- + +{{% alert title="Alpha" color="warning" %}} +The conversation building block is currently in **alpha**. +{{% /alert %}} + +Let's take a look at the [Dapr conversation building block]({{< ref conversation-overview.md >}}), which + +You can try out this conversation quickstart by either: + +- [Running all applications in this sample simultaneously with the Multi-App Run template file]({{< ref "#run-using-multi-app-run" >}}), or +- [Running one application at a time]({{< ref "#run-one-job-application-at-a-time" >}}) + +## Run using Multi-App Run + +Select your preferred language-specific Dapr SDK before proceeding with the Quickstart. Currently, you can experiment with the conversation API with the Go SDK. + +{{< tabs ".NET" >}} + + +{{% codetab %}} + +This quickstart includes two apps: + +### Step 1: Pre-requisites + +For this example, you will need: + +- [Dapr CLI and initialized environment](https://docs.dapr.io/getting-started). +- [.NET SDK or .NET 6 SDK installed](https://dotnet.microsoft.com/download). + +- [Docker Desktop](https://www.docker.com/products/docker-desktop) + + +### Step 2: Set up the environment + +Clone the [sample provided in the Quickstarts repo](https://github.com/dapr/quickstarts/tree/master/conversation). + +```bash +git clone https://github.com/dapr/quickstarts.git +``` + +From the root of the Quickstarts directory, navigate into the conversation directory: + +```bash +cd conversation/csharp/sdk +``` + +### Step 3: + +Run the application and schedule conversation with one command: + +```bash +dapr run -f . +``` + +**Expected output** + +Once the process has completed, you can stop and clean up application processes with a single command. + +```bash +dapr stop -f . +``` + +### What happened? + +When you ran `dapr init` during Dapr install: + +Running `dapr run -f .` in this Quickstart... + +#### `dapr.yaml` Multi-App Run template file + +Running the [Multi-App Run template file]({{< ref multi-app-dapr-run >}}) with `dapr run -f .` starts all applications in your project. In this Quickstart, the `dapr.yaml` file contains the following: + +```yml +``` + +#### `conversation` app + +```csharp + +``` + +{{% /codetab %}} + +{{< /tabs >}} + +## Run one job application at a time + +{{< tabs ".NET" >}} + + +{{% codetab %}} + + +### Step 1: Pre-requisites + +For this example, you will need: + +- [Dapr CLI and initialized environment](https://docs.dapr.io/getting-started). +- [.NET SDK or .NET 6 SDK installed](https://dotnet.microsoft.com/download). + +- [Docker Desktop](https://www.docker.com/products/docker-desktop) + + +### Step 2: Set up the environment + +Clone the [sample provided in the Quickstarts repo](https://github.com/dapr/quickstarts/tree/master/conversation). + +```bash +git clone https://github.com/dapr/quickstarts.git +``` + +From the root of the Quickstarts directory, navigate into the conversation directory: + +```bash +cd conversation/csharp/sdk +``` + +### Step 3: + + + +{{% /codetab %}} + +{{< /tabs >}} + + +## Watch the demo + +See the conversation API in action using a .NET example. + +## Tell us what you think! + +We're continuously working to improve our Quickstart examples and value your feedback. Did you find this Quickstart helpful? Do you have suggestions for improvement? + +Join the discussion in our [discord channel](https://discord.com/channels/778680217417809931/953427615916638238). + +## Next steps + +- SDK samples of this quickstart: + - [.NET](https://github.com/dapr/quickstarts/tree/master/conversation/go/http) +- Learn more about [the conversation building block]({{< ref conversation-overview.md >}}) + +{{< button text="Explore Dapr tutorials >>" page="getting-started/tutorials/_index.md" >}}