copilot openai todo

? второй пилот-опенай-тодо

Этот проект представляет собой пример реализации приложения Todo, целью которого является демонстрация того, как использовать GitHub Copilot для создания приложения todo на базе искусственного интеллекта с использованием Azure OpenAI и Azure Cosmos DB.

Заполненное приложение находится в завершенной ветке.

Предварительные условия

• Node.js 18+
• Докер v20+
• Учетная запись Azure . Если вы новичок в Azure, получите учетную запись Azure бесплатно, чтобы получить бесплатные кредиты Azure для начала работы.
• Подписка Azure с включенным доступом к службе Azure OpenAI . Вы можете запросить доступ с помощью этой формы.
  • Альтернативно вы можете использовать ключ API OpenAI вместо службы Azure OpenAI.

Вы можете использовать кодовые пространства GitHub для работы над этим проектом прямо из браузера: нажмите кнопку «Код» , затем вкладку «Кодовые пространства» и нажмите «Создать кодовые пространства» на главной странице .

Вы также можете использовать расширение Dev Containers для VS Code для локальной работы с использованием готовой к использованию среды разработки.

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

npm install

Детали проекта

Этот проект структурирован как монорепозиторий и использует рабочие области NPM. Это организовано следующим образом:

.devcontainer/    # Dev container configuration
.github/          # GitHub Actions CI/CD pipeline
packages/         # The different parts of our app
| - server/        # The Express server, hosting the API and the website
+- client/        # The website client
package.json      # NPM workspace configuration 

Как построить проект

npm run build

Эта команда соберет пакеты клиента и сервера.

Как настроить развертывание

Чтобы предоставить ресурсы в Azure и развернуть службы, мы используем Azure Dev CLI.

 # Only needed once
azd auth login --use-device-code

# Provision and deploy infrastructure
azd up

Вы также можете подготовить и развернуть инфраструктуру отдельно:

 # Provision infrastructure
azd provision

# Deploy infrastructure
azd deploy

Как запустить локально

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

AZURE_OPENAI_ENDPOINT= < your Azure OpenAI endpoint >
AZURE_COSMOS_DB_ENDPOINT= < your Azure Cosmos DB endpoint >

Поскольку приложение использует службы Azure для выполнения OpenAI и хранилища Cosmos DB, вам необходимо сначала подготовить эти ресурсы в Azure (см. раздел Как настроить развертывание).

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

azd env get-values > .env

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

npm run start

Это запустит как клиент, так и сервер:

• Клиент будет доступен по адресу http://localhost:4200.
• Сервер будет доступен по адресу http://localhost:3000.

Содействие

Этот проект приветствует вклад и предложения. Большинство вкладов требует от вас согласия с Лицензионным соглашением для авторов (CLA), в котором говорится, что вы имеете право и действительно предоставляете нам права на использование вашего вклада. Подробную информацию можно найти на странице https://cla.opensource.microsoft.com.

Когда вы отправляете запрос на включение, бот CLA автоматически определяет, нужно ли вам предоставить CLA, и соответствующим образом оформляет PR (например, проверку статуса, комментарий). Просто следуйте инструкциям бота. Вам нужно будет сделать это только один раз во всех репозиториях, используя наш CLA.

В этом проекте принят Кодекс поведения Microsoft с открытым исходным кодом. Для получения дополнительной информации см. часто задаваемые вопросы о Кодексе поведения или свяжитесь с нами по адресу [email protected], если у вас возникнут дополнительные вопросы или комментарии.

Товарные знаки

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