> For the complete documentation index, see [llms.txt](https://docs-conversational-ai.syntphony.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs-conversational-ai.syntphony.com/studio/parameters-and-variables/parameters.md).

# Parameters

Create and manage reusable static values across projects and environments.

## Overview

**Parameters** are **reusable static values** that help you keep configurations consistent across Syntphony Conversational AI. Create a value once and reference it in supported fields instead of entering the same information multiple times.

Parameters can be created at **Project** or **Environment** level, depending on where the value needs to be available.

***

## Parameter types

<table><thead><tr><th width="216.3392333984375">Type</th><th width="150.7769775390625">Scope</th><th>Use it when</th></tr></thead><tbody><tr><td><strong>Project Parameter</strong></td><td>Current project</td><td>The value is used only within one project.</td></tr><tr><td><strong>Environment Parameter</strong></td><td>Environment</td><td>The value needs to be shared across multiple projects in the same environment.</td></tr></tbody></table>

***

## Creating a Parameter

To create a Parameter, provide the information required to identify it and define the value that will be reused.

* **Name:** identifies the Parameter and is used to reference it in supported fields
* **Description:** explains the purpose of the Parameter and helps other users understand when to use it
* **Value:** the static content that will replace the Parameter reference during execution.

{% hint style="info" %}
**Note:** If a Project Parameter and an Environment Parameter have the same name, the Project Parameter takes precedence within that project.
{% endhint %}

***

## Project Parameters

Project Parameters are created inside a project. Go to: **Studio > Parameters & Variables**. Use Project Parameters for static values that are used only within the current project.

Example:

> **Name:** \
> support\_contact
>
> **Description:**\
> Contact information for the SCAI support team.
>
> **Value:** \
> For additional support, contact the SCAI team through the Support Portal.

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2FnXBQFN7TVVsri7t1no3s%2FCaptura%20de%20Tela%202026-10-17%20a%CC%80s%2011.48.27.png?alt=media&amp;token=79f54a1d-3417-4724-8d0a-37e8ea1458da" alt="Project Parameter Page"><figcaption><p>Project Parameter Page</p></figcaption></figure>

***

## Environment Parameters

Environment Parameters are created at environment level. Go to: **Environment Home > Parameters**. Use Environment Parameters when the same static value is used by multiple projects in the same environment.

Example:

> **Name:** \
> company\_name
>
> **Description:**\
> Company name shared across projects in this environment.
>
> **Value:** \
> Syntphony

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2F6DollcBn73cELaitAVMu%2FCaptura%20de%20Tela%202026-10-17%20a%CC%80s%2011.53.24.png?alt=media&amp;token=237e89b2-a299-4ed1-a0a5-33b4e70ec40b" alt="Environment Parameter Page"><figcaption><p>Environment Parameter Page</p></figcaption></figure>

***

## Using Parameters from the selector

This allows you to reuse existing Parameters or create new ones directly where you need them, while keeping each Parameter centrally managed according to its scope.&#x20;

Once created, the new Parameter is **automatically inserted into the field where it was created**.

* **Project Parameter:** stored in the project's **Parameters** list and available for reuse within that project
* **Environment Parameter:** stored in **Environment Home > Parameters** and available for reuse across projects in the same environment.

If the Parameter you need does not exist yet, click **Add New** and choose the appropriate scope:

Select a Parameter from the list to automatically add it to the field.

In supported fields, the **Parameters & Variables selector** allows you to search for and insert an existing **Project Parameter** or **Environment Parameter** without leaving your current configuration.

<figure><img src="https://4008706377-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fn6zS4HeuuVpRHZEvDiFU%2Fuploads%2F66ztJZgYCsmdAAgYPkr5%2FCaptura%20de%20Tela%202026-10-19%20a%CC%80s%2017.30.53.png?alt=media&amp;token=7fedf0d7-1819-4e41-8e1f-5fa652cea138" alt="Selecting or creating a Parameter from the Parameters &#x26; Variables selector"><figcaption><p>Selecting or creating a Parameter from the Parameters &#x26; Variables selector</p></figcaption></figure>

***

## Managing Parameters

Parameters can be **edited, disabled, or deleted** from the environment and project's Parameters list. Before making changes, consider where the Parameter is being used, as the same Parameter may be referenced in different supported fields.

#### **Edit a Parameter**

Edit a Parameter when you need to update its configuration or value. Changes to the value are reflected wherever the Parameter is referenced. For **Environment Parameters**, this may affect multiple projects, so review its usage before making changes.

#### **Disable a Parameter**

Disable a Parameter when you want to temporarily prevent its value from being used without deleting it. The Parameter remains in the list and its existing references remain visible in supported fields, but **its value is not resolved during execution**. You can enable it again when needed.

#### **Delete a Parameter**

Delete a Parameter when it is no longer needed. Deleting a Parameter makes any existing reference to it **invalid**. References are not automatically removed from the fields where the Parameter was used, so review its usages and update affected fields as needed before deleting it.

{% hint style="info" %}
**Important:** Disabling is recommended when you may need the Parameter again. Delete it only when you are sure it is no longer required.
{% endhint %}

***

## Troubleshooting

| Issue                                                          | Possible cause                                                           | What to do                                                                                                  |
| -------------------------------------------------------------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| A Parameter does not resolve in a field                        | The field may not support Parameters, or the Parameter may be disabled.  | Check whether the field supports Dynamic Content and make sure the Parameter is enabled.                    |
| The value is different from expected                           | A Project Parameter and an Environment Parameter may have the same name. | Check both scopes. When they have the same name, the Project Parameter takes precedence within the project. |
| A value changed across multiple projects                       | An Environment Parameter used by multiple projects was updated.          | Review the Environment Parameter and the projects where it is referenced.                                   |
| A Parameter reference is visible but its value is not resolved | The Parameter was disabled after being added to the field.               | Enable the Parameter or replace it with an active one.                                                      |
| A Parameter reference is no longer valid                       | The Parameter was deleted while still being referenced.                  | Recreate the Parameter or replace the reference in the affected fields.                                     |
| A value must be updated during conversation execution.         | Parameters are static text values.                                       | Use Variables for values that change during conversation execution.                                         |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs-conversational-ai.syntphony.com/studio/parameters-and-variables/parameters.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
