Урок 1. Что такое API и зачем оно агенту

Урок 1. Что такое API и зачем оно агенту#

Цель: понять, что такое API и как оно помогает агенту общаться с другими сервисами.

Что такое API простыми словами#

API (Application Programming Interface) — это «интерфейс для программ», способ, которым одна программа может общаться с другой.

Для не-технаря API — это:

• меню ресторана для программ: вы не идёте на кухню, вы просто выбираете блюдо из меню → повар готовит → официант приносит
• розетка для программ: вы не залезаете в электросеть, вы просто вставляете вилку → получаете электричество

API позволяет вашему агенту:

• читать данные из другого сервиса (например, получить список клиентов из CRM)
• записывать данные в другой сервис (например, создать заказ в магазине)
• выполнять действия (например, отправить email, создать встречу в календаре)

Как это работает#

Пример: агент отправляет email через Gmail API.

1. Агент формирует запрос: «Отправь email на ivan@example.com с темой "Привет" и текстом "Как дела?"»
2. Запрос отправляется в Gmail API (через интернет)
3. Gmail API проверяет авторизацию (имеет ли агент право отправлять email от вашего имени)
4. Gmail API выполняет действие (отправляет email)
5. Gmail API возвращает ответ: «Email отправлен успешно» (или ошибка, если что-то пошло не так)

Схема:

Агент → Запрос (JSON) → Gmail API → Gmail отправляет email → Ответ (JSON) → Агент

Зачем агенту API#

Без API агент был бы изолирован — он мог бы только разговаривать с пользователем.

С API агент может:

• читать данные из CRM, Google Sheets, базы знаний
• отправлять уведомления в Telegram, email, SMS
• создавать задачи в Notion, Trello, Asana
• принимать платежи через Stripe, YooKassa
• звонить через Twilio
• генерировать контент через OpenAI, Midjourney

API превращает агента в полноценный инструмент автоматизации.

Типы API#

1. REST API (самый популярный)

• работает через HTTP (как обычный сайт)
• запросы и ответы в формате JSON
• используют методы: GET (читать), POST (создать), PUT (обновить), DELETE (удалить)

2. GraphQL API

• более гибкий, чем REST
• можно запросить только нужные поля
• используется в современных сервисах (Shopify, GitHub)

3. Webhook (обратный вызов)

• сервис сам отправляет данные вашему агенту, когда происходит событие
• пример: новый заказ → магазин отправляет данные агенту → агент обрабатывает заказ

Для большинства задач вам будет достаточно REST API.

Примеры популярных API#