Инструмент — это обычная функция

Урок 11.2 · Программирование с нуля · Модуль 11. Как устроен ИИ-агент · По подписке

Цель урока: Написать инструмент агента: функцию, которая возвращает результат, а не печатает его.

Нужно знать заранее: Урок 6.1 — функции и return.

Объяснение

Зачем это нужно: Инструмент — самая понятная часть агента. Это функция, которую агент может вызвать. Написав одну, вы уже понимаете, как устроены «умные помощники» изнутри: за красивым названием стоит обычный код, который вы умеете писать.

Как это работает: У инструмента есть три обязательные вещи: понятное имя, параметры и результат.

Имя говорит, что делает функция: order_status, total_by_category, send_email. Хорошее имя читается как действие: «узнай статус заказа», «посчитай сумму по категории».

Параметры — что функции нужно знать: номер заказа, категория, текст письма. Параметры должны быть простыми: число, строка, список. Чем меньше параметров, тем легче агенту не ошибиться.

Результат — что функция отдаёт обратно. Ключевое правило: инструмент возвращает результат через return, а не печатает его. Тогда агент может этот результат проверить, передать дальше или показать человеку. Функция, которая только печатает, возвращает None — и агенту нечего проверять.

Уроки модуля 11

• 11.1 Чем агент отличается от чата (бесплатно)
• 11.2 Инструмент — это обычная функция — вы здесь (по подписке)
• 11.3 Диспетчер: как агент выбирает инструмент (по подписке)
• 11.4 Цикл агента: подумал → вызвал → проверил (по подписке)
• 11.5 Почему агенту нельзя верить на слово (по подписке)
• 11.6 Свой мини-агент: задача целиком (по подписке)
• 11.7 Память агента: как он помнит, что уже сделал (по подписке)
• 11.8 План и шаги: как агент разбивает задачу (по подписке)
• 11.9 Чужие команды: почему агенту нельзя доверять текст (по подписке)
• 11.10 Тест: что вы знаете об агентах (по подписке)