ai-agents-for-beginners

Настройка курса

Введение

В этом уроке мы рассмотрим, как запускать примеры кода из данного курса.

Присоединяйтесь к другим учащимся и получайте помощь

Прежде чем клонировать репозиторий, присоединяйтесь к каналу Discord “AI Agents For Beginners”, чтобы получить помощь с настройкой, задать вопросы по курсу или пообщаться с другими учащимися.

Клонируйте или форкните этот репозиторий

Для начала клонируйте или форкните репозиторий на GitHub. Это создаст вашу собственную версию материалов курса, чтобы вы могли запускать, тестировать и изменять код!

Это можно сделать, перейдя по ссылке:

Forked Repo

Запуск кода

Этот курс предлагает серию Jupyter Notebook, которые вы можете использовать для практического изучения создания AI-агентов.

Примеры кода используют следующие инструменты:

Требуется аккаунт GitHub (бесплатно):

1) Semantic Kernel Agent Framework + GitHub Models Marketplace. Обозначено как (semantic-kernel.ipynb) 2) AutoGen Framework + GitHub Models Marketplace. Обозначено как (autogen.ipynb)

Требуется подписка Azure: 3) Azure AI Foundry + Azure AI Agent Service. Обозначено как (azureaiagent.ipynb)

Мы рекомендуем попробовать все три типа примеров, чтобы понять, какой из них подходит вам лучше всего.

Выбранный вами вариант определит, какие шаги настройки нужно выполнить ниже:

Требования

Мы включили файл requirements.txt в корневую папку этого репозитория, который содержит все необходимые Python-библиотеки для запуска примеров кода.

Вы можете установить их, выполнив следующую команду в терминале в корневой папке репозитория:

pip install -r requirements.txt

Мы рекомендуем создать виртуальное окружение Python, чтобы избежать конфликтов и проблем.

Настройка VSCode

Убедитесь, что вы используете правильную версию Python в VSCode.

image

Настройка для примеров с использованием GitHub Models

Шаг 1: Получите ваш персональный токен доступа (PAT) GitHub

Этот курс использует GitHub Models Marketplace, предоставляющий бесплатный доступ к большим языковым моделям (LLM), которые вы будете использовать для создания AI-агентов.

Чтобы использовать GitHub Models, вам нужно создать персональный токен доступа GitHub.

Это можно сделать, перейдя в ваш аккаунт GitHub.

Пожалуйста, следуйте принципу минимальных привилегий при создании токена. Это означает, что вы должны предоставить токену только те разрешения, которые необходимы для выполнения примеров кода из этого курса.

  1. Выберите опцию Fine-grained tokens в левой части экрана, перейдя в Developer settings.

    Затем выберите Generate new token.

    Generate Token

  2. Введите описательное имя для вашего токена, чтобы позже было легко понять его назначение.

    🔐 Рекомендация по сроку действия токена

    Рекомендуемый срок действия: 30 дней.
    Для большей безопасности вы можете выбрать более короткий срок, например, 7 дней 🛡️.
    Это отличный способ поставить себе цель и завершить курс, пока ваш интерес к обучению высок 🚀.

    Token Name and Expiration

  3. Ограничьте область действия токена вашим форком этого репозитория.

    Limit scope to fork repository

  4. Ограничьте разрешения токена: в разделе Permissions выберите вкладку Account и нажмите кнопку “+ Add permissions”. Появится выпадающее меню. Найдите Models и установите для него галочку. Add Models Permission

  5. Проверьте необходимые разрешения перед созданием токена. Verify Permissions

  6. Перед созданием токена убедитесь, что вы готовы сохранить его в безопасном месте, например, в хранилище паролей, так как он больше не будет отображаться после создания. Store Token Securely

Скопируйте ваш новый токен. Теперь вы добавите его в файл .env, включенный в этот курс.

Шаг 2: Создайте файл .env

Чтобы создать файл .env, выполните следующую команду в терминале:

cp .env.example .env

Эта команда скопирует пример файла и создаст .env в вашем каталоге, где вы заполните значения для переменных окружения.

Скопировав токен, откройте файл .env в вашем любимом текстовом редакторе и вставьте токен в поле GITHUB_TOKEN. GitHub Token Field

Теперь вы должны быть готовы к запуску примеров кода из этого курса.

Настройка для примеров с использованием Azure AI Foundry и Azure AI Agent Service

Шаг 1: Получите конечную точку вашего проекта Azure

Следуйте инструкциям по созданию хаба и проекта в Azure AI Foundry, которые можно найти здесь: Обзор ресурсов хаба.

После создания проекта вам нужно будет получить строку подключения для вашего проекта.

Это можно сделать на странице Overview вашего проекта в портале Azure AI Foundry.

Project Connection String

Шаг 2: Создайте файл .env

Чтобы создать файл .env, выполните следующую команду в терминале:

cp .env.example .env

Эта команда скопирует пример файла и создаст .env в вашем каталоге, где вы заполните значения для переменных окружения.

Скопировав токен, откройте файл .env в вашем любимом текстовом редакторе и вставьте токен в поле PROJECT_ENDPOINT.

Шаг 3: Войдите в Azure

В качестве лучшей практики безопасности мы будем использовать аутентификацию без ключей для аутентификации в Azure OpenAI с помощью Microsoft Entra ID.

Откройте терминал и выполните команду az login --use-device-code, чтобы войти в ваш аккаунт Azure.

После входа выберите вашу подписку в терминале.

Дополнительные переменные окружения — Azure Search и Azure OpenAI

Для урока Agentic RAG (Урок 5) есть примеры, использующие Azure Search и Azure OpenAI.

Если вы хотите запустить эти примеры, вам нужно будет добавить следующие переменные окружения в ваш файл .env:

Страница Overview (Проект)

Центр управления

Страница Models + Endpoints

Портал Azure

Внешняя страница

Настройка аутентификации без ключей

Вместо жесткого кодирования ваших учетных данных мы будем использовать подключение без ключей с Azure OpenAI. Для этого мы импортируем DefaultAzureCredential и позже вызовем функцию DefaultAzureCredential, чтобы получить учетные данные.

from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential

Застряли на каком-то этапе?

Если у вас возникли проблемы с настройкой, присоединяйтесь к нашему

Следующий урок

Теперь вы готовы к запуску кода из этого курса. Удачного изучения мира AI-агентов!

Введение в AI-агентов и их применение


Отказ от ответственности:
Этот документ был переведен с помощью сервиса автоматического перевода Co-op Translator. Несмотря на наши усилия по обеспечению точности, пожалуйста, учитывайте, что автоматические переводы могут содержать ошибки или неточности. Оригинальный документ на его родном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется профессиональный перевод человеком. Мы не несем ответственности за любые недоразумения или неправильные интерпретации, возникающие в результате использования данного перевода.