> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://agentinbox.space/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://agentinbox.space/_mcp/server.

# Google ADK

> Интеграция Agent Inbox с Google Agent Development Kit (ADK)

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

[Google Agent Development Kit (ADK)](https://google.github.io/adk-docs/) — открытый фреймворк для создания AI-агентов. Подключив Agent Inbox к агенту ADK через [MCP-сервер Agent Inbox](https://github.com/agentinbox/agentinbox-mcp), агент сможет на естественном языке создавать ящики, отправлять и получать письма, вести треды и работать с вложениями.

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

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

## Требования

1. [Аккаунт ](https://agentinbox.space/)[Agent Inbox](https://agentinbox-ru.vercel.app/) и API-ключ из[ консоли Agent Inbox](https://agentinbox-ru.vercel.app/)
2. Установленный [Google ADK](https://google.github.io/adk-docs/get-started/) (`pip install google-adk` или `npm install @google/adk`)

## Настройка

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

**`Python`**

```python title="Python"
from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

AGENTINBOX_API_KEY = "YOUR_AGENTINBOX_API_KEY"

root_agent = Agent(
    model="gemini-2.5-pro",
    name="agentinbox_agent",
    instruction="Help users manage email inboxes and send messages",
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "agentinbox-mcp",
                    ],
                    env={
                        "AGENTINBOX_API_KEY": AGENTINBOX_API_KEY,
                    }
                ),
                timeout=30,
            ),
        )
    ],
)
```

**`TypeScript`**

```typescript title="TypeScript"
import { LlmAgent, MCPToolset } from "@google/adk";

const AGENTINBOX_API_KEY = "YOUR_AGENTINBOX_API_KEY";

const rootAgent = new LlmAgent({
    model: "gemini-2.5-pro",
    name: "agentinbox_agent",
    instruction: "Help users manage email inboxes and send messages",
    tools: [
        new MCPToolset({
            type: "StdioConnectionParams",
            serverParams: {
                command: "npx",
                args: ["-y", "agentinbox-mcp"],
                env: {
                    AGENTINBOX_API_KEY: AGENTINBOX_API_KEY,
                },
            },
        }),
    ],
});

export { rootAgent };
```

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

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

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

| Инструмент     | Описание                                   |
| -------------- | ------------------------------------------ |
| `list_inboxes` | Список всех ящиков                         |
| `get_inbox`    | Детали конкретного ящика                   |
| `create_inbox` | Новый ящик с именем пользователя и доменом |
| `delete_inbox` | Удаление ящика                             |

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

| Инструмент       | Описание                      |
| ---------------- | ----------------------------- |
| `list_threads`   | Список тредов в ящике         |
| `get_thread`     | Конкретный тред с сообщениями |
| `get_attachment` | Скачать вложение из сообщения |

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

| Инструмент         | Описание                                               |
| ------------------ | ------------------------------------------------------ |
| `send_message`     | Отправить новое письмо из ящика                        |
| `reply_to_message` | Ответить на существующее сообщение                     |
| `forward_message`  | Переслать сообщение другому получателю                 |
| `update_message`   | Обновить свойства сообщения, например статус прочтения |