AiHummer
Русский▾
ВойтиЛичный кабинет
v1.6.x▾
{ }Swagger

Клиент Runtime и подключение IDE через ACP

v1.6.x · обновлено 2026-11-15

Клиент Runtime и ACP-адаптер используют тот же Core, беседы, агентов и подтверждения, что обычный интерфейс. Подключение IDE не выдаёт ей доступ к файлам или терминалу сервера и не превращает её в доверенного администратора. Используйте действительное подключение исходного пользователя, а не машинный ключ с подставленным именем человека.

Подготовить подключение

Выберите адрес своего Core, существующую рабочую область и доступного вам агента. Сначала клиентское приложение согласует поддерживаемую версию протокола. При несовместимой версии используйте совместимое ПО, а не повторяйте запрос с выдуманной возможностью.

Публичный Go-клиент предоставляет client.NewRuntime, Negotiate, CreateSession, Prompt и Observe. Перед первой отправкой сохраните его ClientMessageID так, чтобы он сохранился после перезапуска. После тайм-аута или перезапуска вызовите Observe для той же беседы и сообщения. Это читает исходный запрос, а не запускает новую генерацию. Не используйте один идентификатор с другим текстом.

Создание новой беседы — отдельное действие. Если подтверждение её создания потерялось, сначала проверьте список бесед: автоматический повтор создания может добавить вторую беседу.

Использовать ACP

ACP-адаптер передаёт сообщения по стандартному вводу и выводу. Настройте -core, -workspace, -agent, -cwd и действительный пользовательский токен в AIHUMMER_RUNTIME_TOKEN. Не помещайте токен в общий проект или журнал. Значение -cwd обозначает проект IDE; оно не подключает каталог компьютера к серверу.

Поддерживается ACP1 и текстовый ввод. Передача произвольного MCP-сервера со стороны IDE, новые файловые или терминальные полномочия, изображения и аудио не принимаются этим адаптером. Отдельные инструменты Core продолжают работать только в пределах уже настроенных прав.

Для каждой беседы допускается один активный запрос. Две независимые беседы могут выполняться независимо. Загрузка беседы показывает сохранённые сообщения и исходные идентификаторы, но не отправляет незавершённый запрос повторно.

Подтверждение, отмена и обрыв связи

Запрос подтверждения инструмента передаётся пользователю с выбором разрешить один раз или отклонить. Пропавший, просроченный или некорректный ответ не означает согласие. Решение всё равно проверяет Core.

Явная отмена относится к конкретному активному исходному запросу. Отмена одной беседы не должна отменять другую. Закрытие соединения само по себе не подтверждает отмену; подтверждение принятого запроса отмены ещё не означает, что все выполнявшиеся операции остановлены. Клиентское приложение различает окончательный результат, принятое фоновое выполнение и неопределённый внешний эффект.

Частичный поток и конец соединения не заменяют сохранённый итог. Если результат неизвестен, восстановите исходное состояние, а не запускайте действие ещё раз. Внешние длительные операции имеют собственную проверку исходного идентификатора.