Contact UsTry it for free
© 2026 Direct Cursus Technology L.L.C.

Creating a simple text agent

Written by
Updated at December 23, 2025

In Yandex AI Studio, you can create a text agent that can communicate with the user in text format and maintain a dialogue closely resembling natural human interaction.

Getting started

To use an example:

  1. Create a service account and assign the ai.assistants.editor and ai.languageModels.user roles to it.

  2. Get and save the service account's API key with yc.ai.foundationModels.execute for its scope.

    Note

    If you are using Windows, we recommend installing the WSL shell first and using it to proceed.

  3. Install Python 3.10 or higher.

  4. Install Python venv to create isolated virtual environments in Python.

  5. Create a new Python virtual environment and activate it:

    python3 -m venv new-env
source new-env/bin/activate

  6. Install the OpenAI library for Python:

    pip install openai

Build a chat

  1. Create a file named index.py and add the following code to it:

    import openai

YANDEX_CLOUD_MODEL = "yandexgpt"

client = openai.OpenAI(
    api_key=YANDEX_CLOUD_API_KEY,
    base_url="https://rest-assistant.api.cloud.yandex.net/v1",
    project=YANDEX_CLOUD_FOLDER
)

response = client.responses.create(
    prompt={
        "id": "........",
        "variables": {
            "city": "Chita",
            "friends_number": "0"
        }
    },
    input="Where should I go for a night out? Where can I smell Ledum?",
)

print(response.output[0].content[0].text)

  2. Save authentication data to environment variables:

    export YANDEX_CLOUD_FOLDER=<folder_ID>
export YANDEX_CLOUD_API_KEY=<API_key>

  3. Run the file you created:

    python index.py

    Response example:

    You can have a great evening in Chita, and here are some ideas:

**1. Where to go out in the evening:**
- **Ostrog art factory**: A modern cultural space that is home to exhibitions, workshops, concerts, and – in summer – frequent themed parties.
- **Irkutskaya Street** and **Downtown Chita**: Stroll along the pedestrian section of Leningradskaya Street, where you will find cozy cafes and bars (e.g., Kruzhka, Sibirskiy Broi, Craft Pub, and Mamina komnata Sushi) and a vibrant urban atmosphere.
- **Chita River Embankment**: A peaceful spot for an evening walk with scenic views.
- **Restaurants with a view**: Try dining on the top floor of Kristall Plaza or at Bely Medved: both offer beautiful city views and a pleasant ambiance.

---

**2. Where to smell Ledum:**
- Chita Botanical Garden at the Far Eastern Branch of the Russian Academy of Sciences (100 Zhuravlyova Street), is home to Rhododendron dauricum (commonly called Ledum, or bagulnik in Russian). It blooms from late May to early June. Contact the garden's administration for up-to-date information.
- City outskirts: Ledum blooms in suburban forests, especially around Arakhley and the lakes in Chita District (e.g., near Lake Tatkholey). Consider a day trip by car or join a guided excursion.
- Eastern and Central Ranges near Chita: From May onward, entire hillsides bloom with fragrant Ledum, perfect for photography and immersive nature experiences.

**Important:** When enjoying the scent of Ledum, please do not break branches or pick flowers, since it's a rare and ecologically valuable plant in the region!

If you are interested in finding specific Ledum-related excursions or booking evening venues, let me know your preferences, and I will help you plan!

See also

Previous
Tuning an embedding model
Next
Creating a text agent with a function call