Урок 6. Практика: подключить внешний сервис

Урок 6. Практика: подключить внешний сервис#

Цель: подключить один внешний сервис к агенту и протестировать интеграцию.

Задача: отправить уведомление в Telegram при добавлении клиента в Google Sheets#

Инструменты: Google Sheets + Telegram Bot + Zapier (или Make, или n8n).

Шаг 1. Создать бота в Telegram#

1. Напишите @BotFather
2. Отправьте /newbot
3. Введите имя бота (например, «Мой бот уведомлений»)
4. Введите username (например, my_notifications_bot)
5. Скопируйте API Token (например, 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz)
6. Напишите своему боту /start (чтобы бот мог отправлять вам сообщения)

Шаг 2. Узнать свой Chat ID#

1. Напишите своему боту любое сообщение
2. Откройте в браузере:

https://api.telegram.org/bot<ВАШ_ТОКЕН>/getUpdates

(замените <ВАШ_ТОКЕН> на токен из шага 1)

3. Найдите в ответе "chat":{"id":123456789} — это ваш Chat ID
4. Сохраните Chat ID

Шаг 3. Создать таблицу в Google Sheets#

Создайте таблицу «Клиенты» с полями:

Шаг 4. Создать автоматизацию в Zapier#

Триггер:

• приложение: Google Sheets
• событие: New Spreadsheet Row
• авторизация: дайте доступ к Google Sheets
• выберите таблицу и лист
• протестируйте (Zapier найдёт последнюю строку)

Действие:

• приложение: Webhooks by Zapier
• действие: POST
• URL:

https://api.telegram.org/bot<ВАШ_ТОКЕН>/sendMessage

• Method: POST
• Data (JSON):

{
  "chat_id": "<ВАШ_CHAT_ID>",
  "text": "Новый клиент: {{Name}} ({{Email}})"
}

(замените <ВАШ_CHAT_ID> на ваш Chat ID из шага 2)

• протестируйте (вы получите сообщение в Telegram)

Включите Zap:

• нажмите «Publish»

Шаг 5. Протестировать#

1. Добавьте новую строку в таблицу Google Sheets:

2. Подождите 1–2 минуты (Zapier проверяет таблицу раз в 1–15 минут в зависимости от тарифа)
3. Вы получите сообщение в Telegram:

Новый клиент: Мария Сидорова (maria@example.com)

Готово! Интеграция работает.

Чек-лист проверки интеграции#

• Триггер работает (Zapier находит новую строку)
• Действие выполняется (сообщение отправляется в Telegram)
• Данные передаются корректно (имя и email из таблицы попадают в сообщение)
• Нет ошибок в логе Zapier
• Задержка приемлема (1–15 минут)

Практика#

Практическое задание 1: прочитать документацию API#

Задача: прочитать документацию Telegram Bot API и найти, как отправить изображение.

Действия:

1. Откройте core.telegram.org/bots/api
2. Найдите метод для отправки изображения (подсказка: sendPhoto)
3. Прочитайте, какие параметры нужны
4. Найдите пример запроса

Ответьте на вопросы:

• Какой метод используется для отправки изображения?
• Какие параметры обязательны?
• Можно ли отправить изображение по URL (без загрузки файла)?

• Метод: sendPhoto
• Обязательные параметры: chat_id, photo
• По URL: Да, можно передать URL изображения в параметр photo

Практическое задание 2: получить API-ключ#

Задача: получить API-ключ для одного из сервисов (на выбор).

Варианты:

• Telegram Bot API — создайте бота через @BotFather
• OpenAI API — зарегистрируйтесь на platform.openai.com и создайте API-ключ
• Google Sheets API — создайте проект в Google Cloud Console (сложнее, но полезно)

Чек-лист:

• Получен API-ключ
• Ключ сохранён в безопасном месте (не в коде, не в чате)
• Протестирован (сделан тестовый запрос)

Практическое задание 3: подключить внешний сервис через коннектор#

Задача: повторите пример из Урока 6 (Google Sheets + Telegram Bot + Zapier).

Требования:

• триггер: новая строка в Google Sheets
• действие: отправка сообщения в Telegram
• тестирование: добавьте строку → получите сообщение

Чек-лист:

• Бот создан, токен получен
• Chat ID получен
• Таблица создана
• Zap создан и включён
• Тестирование пройдено (сообщение получено)

Практическое задание 4: Практика в Coze — подключить внешний API#

Задача:
Создайте агента в Coze, который по запросу пользователя получает актуальную информацию через внешний API (например, курс криптовалюты, погода, курс валют).

Что сделать:

1. Выберите API для подключения (простые, бесплатные):

   • CoinGecko API (курс криптовалют): https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd
   • OpenWeather API (погода): https://api.openweathermap.org/data/2.5/weather?q=Moscow&appid=YOUR_KEY
   • ExchangeRate API (курс валют): https://api.exchangerate-api.com/v4/latest/USD

2. Создайте нового агента в Coze:

   • Название: «Инфо-агент» или «Курс криптовалют»

3. Напишите промпт:

Ты — информационный помощник.

Твоя задача: по запросу пользователя получай актуальную информацию через API и отвечай.

Что ты умеешь:
- Показать текущий курс Bitcoin (используй API CoinGecko)
- [Другие функции, если добавите]

Правила:
- Когда пользователь спрашивает курс Bitcoin, используй HTTP Request к API
- Извлеки цену из ответа
- Ответь: "Текущий курс Bitcoin: $[цена] USD"

Формат:
- Короткий ответ
- Всегда указывай время обновления: "По данным на [время]"

4. Подключите HTTP Request в Coze:

   • Skills → Add Skill → HTTP Request (или аналог)
   • Настройте запрос:
     • Method: GET
     • URL: https://api.coingecko.com/api/v3/simple/price?ids=bitcoin&vs_currencies=usd
   • Протестируйте: Execute → вы должны получить JSON с ценой

5. Обработайте ответ:

   • Если Coze поддерживает обработку JSON в промпте, извлеките значение bitcoin.usd
   • Если нет — используйте встроенный инструмент обработки данных (если есть)

6. Протестируйте агента:

   • Напишите: «Какой курс Bitcoin?»
   • Агент должен ответить: «Текущий курс Bitcoin: $45000 USD (по данным на 10:30)»

Чек-лист:

• API выбран (CoinGecko или другой)
• Агент создан в Coze
• Промпт написан (с инструкцией по использованию HTTP Request)
• HTTP Request настроен (URL, метод GET)
• Тестирование пройдено (агент возвращает актуальный курс)

Что вы получите:
Опыт подключения внешнего API к агенту в Coze. Понимание, как агент может получать актуальные данные из интернета в реальном времени.

Время: 30-40 минут

Примечание:
Если в Coze нет прямого HTTP Request (или сложно настроить), используйте готовые плагины (например, плагин для погоды или курса валют, если доступны). Главное — понять принцип работы с внешними API.

Практическое задание 5: рассчитать стоимость использования API#

Задача: оцените, сколько будет стоить использование OpenAI API для вашего агента.

Исходные данные:

• вы планируете агента поддержки для сайта
• ~500 диалогов в месяц
• каждый диалог: пользователь пишет ~200 символов (~50 токенов), агент отвечает ~800 символов (~200 токенов)
• модель: GPT-4o mini
• стоимость (2026): $0.00015 за 1000 input tokens, $0.0006 за 1000 output tokens

Расчёт:

1. Input токенов на диалог: 50
2. Output токенов на диалог: 200
3. Стоимость одного диалога:
   • Input: (50 / 1000) × $0.00015 = $0.0000075
   • Output: (200 / 1000) × $0.0006 = $0.00012
   • Итого: $0.0001275 (~$0.00013)
4. Стоимость 500 диалогов: 500 × $0.00013 = $0.065 (~$0.07)

Ответ: ~$0.07/месяц (или ~6 рублей/месяц по курсу 90 ₽/$).

Ваша задача:

Рассчитайте стоимость для:

• 2000 диалогов в месяц
• модель GPT-5 ($0.01 за 1000 input tokens, $0.03 за 1000 output tokens)
• каждый диалог: 100 input токенов, 300 output токенов

• Input: (100 / 1000) × $0.01 = $0.001
• Output: (300 / 1000) × $0.03 = $0.009
• Итого на диалог: $0.01
• Итого на 2000 диалогов: 2000 × $0.01 = $20/месяц

Бонус: а если использовать DeepSeek-R1?

• Input: (100 / 1000) × $0.003 = $0.0003
• Output: (300 / 1000) × $0.003 = $0.0009
• Итого на диалог: $0.0012
• Итого на 2000 диалогов: 2000 × $0.0012 = $2.40/месяц (в 8 раз дешевле!)

Артефакты#

После прохождения модуля у вас будет:

1. Рабочая интеграция#

• Google Sheets + Telegram Bot + Zapier (или аналог)
• триггер: новая строка → действие: уведомление в Telegram

2. Чек-лист «Как читать API-документацию»#

• список шагов для поиска нужного эндпоинта и параметров
• можно использовать для любого API

3. Чек-лист «Проверка интеграции перед запуском»#

• Триггер работает (событие обнаруживается)
• Действие выполняется (запрос отправляется)
• Авторизация настроена (ключ работает)
• Данные передаются корректно (поля заполняются)
• Ошибки обрабатываются (агент не падает при сбое)
• Лимиты учтены (не превышаем Rate Limits)
• Стоимость рассчитана (знаем, сколько платим)
• Логирование включено (видим, что происходит)

4. Калькулятор стоимости API#

Шаблон для расчёта стоимости использования API:

Материалы для сайта#

Карточки для запоминания#