Дайте каждому задеплоенному приложению inbox

Разработчики постоянно выпускают приложения: предварительные развертывания, внутренние инструменты, агенты по работе с клиентами, прототипы выходного дня, которые переходят в производство. Многим из этих приложений необходимо отправлять и получать электронную почту. Подключение личной учетной записи SMTP к каждому развертыванию приводит к утечке секретов и потере потоков, когда ноутбук спит. Более чистый шаблон — предоставить каждому развернутому приложению папку «Входящие» через вызов API по тому же пути подготовки, по которому создается база данных.

Звоните в папку «Входящие» агента из любого места, где вы размещаете

Независимо от того, работает ли приложение на Vercel, Railway, в контейнере на вашем VPS или в песочнице Neuro OS, плоскостью почтовых данных может быть папка «Входящие агента». При загрузке или при первой подготовке пользователя создайте или извлеките папку «Входящие» идемпотентно. Сохраните идентификатор папки «Входящие» в конфигурации среды приложения. Получите через вебхук или опрос. Отправляйте через API с включенным Ask в вашей плоскости управления или в Neuro OS, если работа принадлежит роли.

Это шаблон интеграции, а не заявление о листинге на какой-либо торговой площадке. Вы приносите ключ API. Вы являетесь владельцем приложения. Почтовый ящик — это зависимость, подобная объектному хранилищу — ограниченная средой и с возможностью ротации.

Почему важна идентичность каждого приложения

Приложения предварительной версии не должны использовать один и тот же рабочий почтовый идентификатор. Staging не должен иметь возможности отправлять электронные письма реальным клиентам без контроля. Почтовые ящики для каждого развертывания или для каждой среды сохраняют небольшой радиус взрыва. При удалении предварительного просмотра удалите его почтовый ящик. При ротации производства меняйте учетные данные, не прикасаясь к ноутбукам разработчиков и не копируя файлы .env через чат.

Назовите почтовые ящики в честь приложения и среды, чтобы служба поддержки могла определить, на какую поверхность ответил клиент. Избегайте симпатичных общих псевдонимов, которые переживут развертывание, в котором они были созданы.

Сопряжение с Neuro OS, когда приложение является агентом

Если развернутое приложение на самом деле представляет собой роль — бот поддержки, консьерж по адаптации, оперативный отдел — запустите рассуждения и соединители в Neuro OS. Храните там определенные git навыки, песочницы и политику Ask. Используйте папку «Входящие агента» в качестве электронной почты, которую приложение предоставляет пользователям и поставщикам. Перенаправляйте эскалации людям с неповрежденным потоком, поэтому развертывание не является единственным пользовательским интерфейсом эскалации.

Практический контрольный список

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

Каждое развернутое приложение, которое должно общаться по электронной почте, заслуживает адреса, который не является вашим личным почтовым ящиком. Подготавливайте его так же, как вы подготавливаете базу данных — на ранней стадии, автоматически и в масштабе всей среды — чтобы электронная почта перестала быть случайной единственной точкой уязвимости человека.

Локальная разработка и развернутая идентичность

Разработчики часто подключают личный SMTP к локальному хосту и забывают его заменить. Заставьте приложение отказываться загружаться в промежуточной или рабочей среде без идентификатора папки «Входящие» агента, позволяя при этом четко обозначить локальный макет для модульных тестов. Это единственное ограждение предотвращает наиболее распространенную утечку секретов в демонстрационных версиях агентов: личный пароль, хранящийся в переменной среды развертывания.

Держите человеческий путь очевидным

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

[Входящие агента] (https://agentinbox-ru.vercel.app/) предоставляет каждой роли почтовый ящик, на который люди могут отвечать, с пересылкой в ​​Neuro OS, когда человек должен увидеть ветку. По умолчанию для исходящей почты установлено значение «Спросить». Запустите роль в Neuro OS. Чтобы определить размер первого почтового ящика, начните.

Узнать про Neuro OS →