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-персонажи с постоянными системными промптами. Вместо того чтобы отправлять длинное системное сообщение при каждом запросе, вы создаёте ассистента один раз и ссылаетесь на него по ID.
Создание ассистента
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 ассистента вместо повторения системного промпта:
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"])
Ассистенты из маркетплейса
Используйте готовых ассистентов, созданных сообществом:
# Список доступных ассистентов маркетплейса
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 слов, если не просят иначе." |
Управление ассистентами
# Список ваших ассистентов
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)
Ассистенты хранят только инструкции — не историю разговора. Каждый вызов /generate с assistant_id не имеет состояния. Управляйте многоходовым контекстом самостоятельно, передавая полный массив messages.
