# Ask Koncierge

### Overview

This procedure interacts with **Koncierge** (virtual assistant)\_, to perform tasks, answer questions, or generate content using LLM models. You can customize the response based on creativity, model selection, and response format. Koncierge can work with both text and visual inputs.

{% hint style="warning" %}
Make sure to add the **Document Processing Book** to your agent before using this automation procedure.
{% endhint %}

{% hint style="info" %}
**Ask Koncierge** is a foundational automation procedure. Review the [comparison](https://docs.kognitos.com/llms/when-to-use-ask-koncierge-or-extract) to determine whether ask koncierge procedures or extract procedures better suit your use case.
{% endhint %}

### Syntax

Below is a line-by-line overview of the automation syntax. Expand each line to learn more.

<details>

<summary><code>ask koncierge</code></summary>

#### What does it do?

Begins interaction with the Koncierge virtual assistant.

#### Where does it go?

This phrase should be written on a **new line**.

#### Is it required?

✅ Yes — This phrase is **required**.

#### Does it require data?

❌ No — This phrase does not require data.

</details>

<details>

<summary><code>the message is "your-message"</code></summary>

#### What does it do?

Specifies a message for Koncierge to process.

#### Where does it go?

Indented under `ask koncierge`.

#### Is it required?

❌ No — This phrase is **optional**.

#### Does it require data?

✅ Yes — Replace **your-message** with the message you want Koncierge to handle.

#### Example

```
the message is "What's the weather like in Paris today?"
```

</details>

<details>

<summary><code>the question is "your-question"</code></summary>

#### What does it do?

Specifies a question for Koncierge to answer.

#### Where does it go?

Indented under `ask koncierge`.

#### Is it required?

❌ No — This phrase is **optional**.

#### Does it require data?

✅ Yes — Replace **your-question** with the question you want answered.

#### Example

```
the question is "How do I reset my password?"
```

</details>

<details>

<summary><code>the task is "your-task"</code></summary>

#### What does it do?

Specifies a task for Koncierge to perform.

#### Where does it go?

Indented under `ask koncierge`.

#### Is it required?

❌ No — This phrase is **optional**.

#### Does it require data?

✅ Yes — Replace **your-task** with the task you want Koncierge to complete.

#### Example

```
the task is "Generate a poem about the sea"
```

</details>

<details>

<summary><code>the creativity is x</code></summary>

#### What does it do?

Adjusts the creativity of the response.

#### Where does it go?

Indented under `ask koncierge`.

#### Is it required?

❌ No — This phrase is **optional**.

#### Does it require data?

✅ Yes — Replace **x** with a number between 0.0 and 1.0. Higher values result in more creative responses.

#### Example

```
the creativity is 0.9
```

</details>

<details>

<summary><code>the openai model is "openai-model"</code></summary>

#### What does it do?

Specifies the OpenAI model to use for generating the response.

#### Where does it go?

Indented under `ask koncierge`.

#### Is it required?

❌ No — This phrase is **optional**.

#### Does it require data?

✅ Yes — Replace **openai-model** with a valid OpenAI model name.

#### Example

```
the openai model is "gpt-4o"
```

</details>

<details>

<summary><code>the gemini model is "gemini-model"</code></summary>

#### What does it do?

Specifies the Gemini model to use for generating the response.

#### Where does it go?

Indented under `ask koncierge`.

#### Is it required?

❌ No — This phrase is **optional**.

#### Does it require data?

✅ Yes — Replace **gemini-model** with a valid Gemini model name.

#### Example

```
the gemini model is "gemini-2.5"
```

</details>

<details>

<summary><code>the system command is "your-command"</code></summary>

#### What does it do?

Provides system-level instructions to influence the response.

#### Where does it go?

Indented under `ask koncierge`.

#### Is it required?

❌ No — This phrase is **optional**.

#### Does it require data?

✅ Yes — Replace **your-command** with instructions for how Koncierge should behave.

#### Example

```
the system command is "You are a helpful assistant"
```

</details>

<details>

<summary><code>the response format is "response-format"</code></summary>

#### What does it do?

Specifies the desired format of the response.

#### Where does it go?

Indented under `ask koncierge`.

#### Is it required?

❌ No — This phrase is **optional**.

#### Does it require data?

✅ Yes — Replace **response-format** with one of the following: **string**, **text**, **date**, **table**, **list of texts**, **list of numbers**, **list of dates**, **list of records**, **structured data**, **json**. The default is **string**.

#### Example

```
the response format is "json"
```

</details>

### Examples

#### 1. Ask a Simple Question

```
ask koncierge
    the message is "What's the weather like in Paris today?"
```

#### 2. Generate Creative Content

```
ask koncierge
    the task is "Generate a poem about the sea"
    the creativity is 0.9
```

#### 3. Ask with System Instructions

```
ask koncierge
    the question is "How do I reset my password?"
    the system command is "You are a technical support expert"
```

#### 4. Extract Structured Data

```
ask koncierge
    the task is "Extract invoice details as JSON"
    the openai model is "gpt-4o"
    the response format is "json"
```