Почтовый агент на Google ADK и Agent Inbox

Комплект разработки агентов Google — это способ определения агентов, инструментов и исполнителей на языке Python. Ему не обязательно становиться проектом Gmail OAuth. Если у агента должен быть почтовый ящик, на который люди могут отвечать, предоставьте ему Входящие агента через MCP/stdio или обычные инструменты HTTP. Не трогайте SMTP. Не храните пароль почтового ящика пользователя. Черновики ждут по запросу.

Это инструкция по использованию шаблона: ADK в качестве среды выполнения агента, Входящие агента в качестве почтового ящика, Neuro OS в качестве плоскости управления компанией, когда вы готовы выполнить ту же роль с политикой и проверкой.

Инструменты над транспортами

Агенты ADK вызывают инструменты. Вы можете открыть папку «Входящие агента» двумя способами:

• MCP/stdio: запустите сервер MCP входящей почты агента как подпроцесс и позвольте ADK использовать эти инструменты.
• HTTP: оберните REST API в функции Python — create_inbox, list_threads, get_message, search, create_draft.

HTTP является явным и легко тестируемым. MCP удобен, если вы уже стандартизировали MCP во всех средах выполнения. Выберите один для каждого проекта. Смешение обоих в одном агенте обычно приводит к дублированию инструментов и путанице в модели.

Предоставление один раз, за пределами горячего пути:

из агентинбокса импортировать AgentInbox
клиент = AgentInbox()
входящие = client.inboxes.create(username="adk-mail", домен="agentinbox.space")

Передайте inbox.id в инструкцию агента как константу. Модель не должна создавать новый почтовый ящик, потому что в подсказке написано «привет».

Агент Python, без SMTP

Минимальный почтовый агент ADK: получает идентификатор входящего потока (от рабочего веб-перехватчика), получает сообщения, классифицирует и вызывает create_draft. Инструмент отправки либо не существует, либо его работа завершается только после наличия записи об утверждении. В Neuro OS эта запись — Ask. В локальном средстве запуска ADK это может быть подтверждение CLI или небольшая страница обзора. Не используйте smtplib.sendmail из инструмента «только для демонстрации». Демо становятся продукцией.

Храните ключи API в среде бегуна, а не в тексте инструкции. Записывайте названия инструментов и идентификаторы потоков. Не регистрируйте тела сообщений в общих каналах отладки.

Черновики плюс вопрос

Граница продукта, которая имеет значение, — это исходящая. Агент может прочитать. Агент может искать. Агент может написать черновик. Человек отправляет. Если вы подключаете инструмент CRM к тому же агенту ADK, это тоже пишет Ask.

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

Потоковые заголовки остаются работой платформы. Вы передаете идентификатор потока; Agent Inbox поддерживает общение. Справочная информация находится в потоках электронной почты для агентов ИИ.

Первый цикл ADK, который вы можете протестировать

Напишите три модульных теста, для которых не требуется модель: список инструментов ограничен одним почтовым ящиком; create_draft не отправляет; второе идентичное входящее событие не создает двух черновиков. Затем запустите одну живую ветку: вы отправляете электронное письмо агенту, исполнитель составляет черновики, вы одобряете, вы видите ответ.

Если один и тот же рабочий процесс должен выполняться для всей команды, переместите эту роль в Neuro OS. ADK может оставаться инструментом создания прототипов инструментов. Шлюзы, инструкции, поддерживаемые git, и путь пересылки для людей — это уровень компании.

Пропустите Gmail OAuth, если только вы не проводите личный эксперимент, который хотите отменить. Производственные агенты получают почтовый ящик API. Вот и весь дизайн.

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

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