> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elumenta.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Руководство по ассистентам

> Создавайте и используйте кастомных AI-ассистентов с постоянными инструкциями и контекстом

Ассистенты — это переиспользуемые AI-персонажи с постоянными системными промптами. Вместо того чтобы отправлять длинное системное сообщение при каждом запросе, вы создаёте ассистента один раз и ссылаетесь на него по ID.

## Создание ассистента

```python theme={null}
import requests

response = requests.post(
    "https://elumenta.ru/api/v2/assistants",
    headers={"Authorization": "Bearer nb_YOUR_API_KEY"},
    json={
        "name": "Бот поддержки клиентов",
        "model": "claude-sonnet-4.5",
        "instructions": "Ты дружелюбный агент поддержки Elumenta. Отвечай на вопросы о ценах, моделях и использовании API. Будь кратким и полезным. Если не знаешь ответа — скажи об этом.",
        "description": "Обрабатывает запросы в службу поддержки"
    }
)

assistant = response.json()
print(assistant["id"])  # asst_01j9x2abc123
```

## Использование ассистента

После создания используйте ID ассистента вместо повторения системного промпта:

```python theme={null}
response = requests.post(
    "https://elumenta.ru/api/v2/generate",
    headers={"Authorization": "Bearer nb_YOUR_API_KEY"},
    json={
        "assistant_id": "asst_01j9x2abc123",
        "messages": [
            {"role": "user", "content": "В чём разница между тарифами Pro и VIP?"}
        ]
    }
)

print(response.json()["content"])
```

## Ассистенты из маркетплейса

Используйте готовых ассистентов, созданных сообществом:

```python theme={null}
# Список доступных ассистентов маркетплейса
response = requests.get(
    "https://elumenta.ru/api/v2/assistants/marketplace",
    headers={"Authorization": "Bearer nb_YOUR_API_KEY"},
    params={"category": "productivity", "limit": 10}
)

for assistant in response.json()["items"]:
    print(f"{assistant['name']} — {assistant['description']}")
```

## Примеры использования

| Сценарий        | Пример инструкций                                                                                 |
| --------------- | ------------------------------------------------------------------------------------------------- |
| Ревью кода      | `"Проверяй код на баги, уязвимости безопасности и стиль. Давай конкретные замечания по строкам."` |
| Переводчик      | `"Переводи весь ввод пользователя на русский. Сохраняй форматирование и тон."`                    |
| Аналитик данных | `"Анализируй предоставленные данные. Всегда возвращай структурированный JSON с инсайтами."`       |
| Email-писатель  | `"Пиши профессиональные деловые письма. Краткость — не более 150 слов, если не просят иначе."`    |

## Управление ассистентами

```python theme={null}
# Список ваших ассистентов
requests.get("/api/v2/assistants", headers=headers)

# Обновить ассистента
requests.put("/api/v2/assistants/asst_01j9x2abc123",
    headers=headers,
    json={"instructions": "Обновлённые инструкции..."}
)

# Удалить ассистента
requests.delete("/api/v2/assistants/asst_01j9x2abc123", headers=headers)
```

<Note>
  Ассистенты хранят только инструкции — не историю разговора. Каждый вызов `/generate` с `assistant_id` не имеет состояния. Управляйте многоходовым контекстом самостоятельно, передавая полный массив `messages`.
</Note>