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

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

import requests

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

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

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

После создания используйте ID ассистента вместо повторения системного промпта: 
response = requests.post(
    "https://neuralbox.top/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://neuralbox.top/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.