Google ADK

Начало работы

Google Agent Development Kit (ADK) — открытый фреймворк для создания AI-агентов. Подключив Agent Inbox к агенту ADK через MCP-сервер Agent Inbox, агент сможет на естественном языке создавать ящики, отправлять и получать письма, вести треды и работать с вложениями.

Сценарии использования

• Собственные ящики для агентов: выделенные адреса, чтобы агенты независимо отправляли и получали почту, как коллега-человек.
• Автоматизация почтовых процессов: агент ведёт переписку от первого письма до ответов и напоминаний в треде.
• Несколько ящиков и переписок: список и поиск по тредам и сообщениям, пересылка, вложения — агент остаётся в контексте.

Требования

1. Аккаунт Agent Inbox и API-ключ из консоли Agent Inbox
2. Установленный Google ADK (pip install google-adk или npm install @google/adk)

Настройка

ADK подключает Agent Inbox через интерфейс MCP-инструментов. Подключите MCP-сервер Agent Inbox как локальный stdio-транспорт:

1
from google.adk.agents import Agent
2
from google.adk.tools.mcp_tool import McpToolset
3
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
4
from mcp import StdioServerParameters
5
6
AGENTINBOX_API_KEY = "YOUR_AGENTINBOX_API_KEY"
7
8
root_agent = Agent(
9
    model="gemini-2.5-pro",
10
    name="agentinbox_agent",
11
    instruction="Help users manage email inboxes and send messages",
12
    tools=[
13
        McpToolset(
14
            connection_params=StdioConnectionParams(
15
                server_params=StdioServerParameters(
16
                    command="npx",
17
                    args=[
18
                        "-y",
19
                        "agentinbox-mcp",
20
                    ],
21
                    env={
22
                        "AGENTINBOX_API_KEY": AGENTINBOX_API_KEY,
23
                    }
24
                ),
25
                timeout=30,
26
            ),
27
        )
28
    ],
29
)

Доступные инструменты

После подключения агент ADK получает следующие инструменты Agent Inbox:

Управление ящиками

Управление тредами

Операции с сообщениями