# Assistant API

### Что такое Assistant API?

Assistant API - это программный интерфейс, позволяющий взаимодействовать с интеллектуальными ассистентами, созданными на нашей платформе. Ассистент - это настраиваемый виртуальный помощник, способный выполнять различные задачи с использованием искусственного интеллекта.

### Преимущества использования Assistant API

* **Простота интеграции**: Всего один API-запрос для взаимодействия с ассистентом.
* **Гибкость настройки**: Легко изменяйте поведение ассистента через веб-интерфейс.
* **Не требует передачи контекста:** Не нужно заботиться о том, где и как сохранять историю переписки, просто отправляйте вопросы, ассистент сам позаботится о контексте.
* **Разнообразие моделей**: Доступ к различным языковым моделям, таким как Claude, GPT и другие.
* **Автоматическое применение настроек**: Все параметры ассистента применяются к запросам без дополнительного кодирования.
* **Расширенные возможности**: Поддержка векторных баз данных и сторонних API-интеграций.

### Принцип работы

Взаимодействие с Assistant API осуществляется через авторизованные POST-запросы. Данные передаются в формате JSON.

<figure><img src="/files/hjVviO5FZpZz8XB1KY6p" alt=""><figcaption><p>Общая схема взаимодействия с ассистентом GPTunneL</p></figcaption></figure>

### Как начать использовать Assistant API

1. Создайте ассистента на нашей платформе (подробности в [нашем блоге](https://gptunnel.ru/blog/ai-assistant-how-to/)).
2. Получите API-ключ в личном кабинете (в бизнес профиле).
3. Интегрируйте API-запрос [`assistant/chat`](/assistant/chat.md) в ваш сервис.
4. Начните получать ответы от вашего ассистента!

### Часто задаваемые вопросы (FAQ)

**Как изменить модель ассистента?** \
\
Вы можете изменить модель в один клик через наш веб-интерфейс. Новая модель будет автоматически использоваться в последующих запросах.

***

**Как настроить поведение ассистента?**  \
\
В веб-интерфейсе вы можете задать инструкции, настроить температуру генерации и другие параметры.

***

**Можно ли использовать собственные данные?**\
\
Да, вы можете загрузить собственные данные в инструкцию или в векторную базу данных для улучшения ответов ассистента.

***

**Можно ли отправлять изображения ассистенту?**\
\
Да, вы можете отправлять фотографии и картинки ассистенту в виде ссылок, используя специальный параметр `images` в нашем API.

***

**Поддерживаются ли длительные разговоры?**&#x20;

Да, вы можете использовать `chat_id` для поддержания контекста в длительных беседах до 20 последних сообщений.

***

Если у вас остались вопросы по интеграции ассистентов, вы можете задать их в нашем Телеграм сообществе: <https://t.me/gptunnel_ru>

или напрямую в техническую поддержку **@ScriptHeads**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gptunnel.ru/assistant/about.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.