1. Введение
В этой кодовой лаборатории вы можете найти инструкции по созданию службы суммирования в рабочей области Slack путем обеспечения интеграции с командой Slack Slash .
Пользователь вызывает косую черту /summarize и вводит текст, который нужно суммировать. Затем приложение Slack вызывает связанную облачную функцию, которая принимает текст и вызывает API PaLM для обобщения. Обобщенный текст затем возвращается обратно команде Slack Slash и отображается в качестве ответа в приложении Slack.
. Список используемых сервисов Google Cloud:
- Облачные функции
- Vertex AI PaLM API
- Облачная регистрация
Что ты построишь
Вы создадите
- Облачная функция, которая вызывает API PaLM для суммирования текста, поступающего из Slack, с помощью команды Slash.
- Приложение Slack, которое вызывает вышеуказанную облачную функцию для обобщения.
2. Требования
3. Прежде чем начать
- В Google Cloud Console на странице выбора проекта выберите или создайте проект Google Cloud.
- Убедитесь, что для вашего проекта Google Cloud включена оплата. Узнайте, как проверить, включена ли оплата в проекте.
- Убедитесь, что API облачных функций и API Vertex AI включены.
- Активируйте Cloud Shell из консоли Google Cloud, следуя инструкциям здесь.
- Если ваш проект не установлен, используйте следующую команду, чтобы установить его:
gcloud config set project <YOUR_PROJECT_ID>
- В Cloud Shell установите следующие переменные среды:
export GCP_PROJECT=<YOUR_PROJECT_ID>
export GCP_REGION=us-central1
4. Развертывание облачной функции
Чтобы создать и развернуть облачные функции, выполните следующие действия:
- Клонируйте код из репозитория https://github.com/rominirani/genai-apptemplates-googlecloud , выполнив следующую команду в терминале Cloud Shell:
git clone https://github.com/rominirani/genai-apptemplates-googlecloud
- Эта команда клонирует содержимое репозитория в папку genai-templates-googlecloud.
- Перейдите в папку интересующего нас проекта, выполнив следующую команду из терминала Cloud Shell:
cd genai-apptemplates-googlecloud/summarization-slack
- Вы должны увидеть файлы main.py и require.txt в папке summarization-slack, выполнив команду dir или перейдя в редактор Cloud Shell.
- Чтобы развернуть функцию облака, выполните команду развертывания функций gcloud :
gcloud functions deploy summarizeText \
--gen2 \
--runtime=python311 \
--source=. \
--region=$GCP_REGION \
--project=$GCP_PROJECT \
--entry-point=summarizeText \
--trigger-http \
--set-env-vars=GCP_PROJECT=$GCP_PROJECT,GCP_REGION=$GCP_REGION \
--max-instances=1
После развертывания облачной функции URL-адрес развернутой облачной функции отображается в терминале Cloud Shell. URL-адрес имеет следующий формат:
https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
Обратите внимание на отображаемый URL-адрес: он потребуется для создания команды Slack Slash.
5. Создайте команду Slack Slash.
Давайте создадим собственную команду Slash в Slack. Эта пользовательская команда /summarize вызывает функцию облака, которую мы развернули в предыдущем разделе.
Чтобы создать команду косой черты, выполните следующие действия:
- Перейдите на api.slack.com/apps .
- Нажмите «Создать новое приложение».
- В окне «Создать приложение» выберите вариант «С нуля» .
- Введите имя для вашего приложения. Например,
Summarization Slack Application.Выберите рабочую область Slack для разработки вашего приложения. - Нажмите «Создать приложение» . Откроется страница настроек .
- На странице настроек нажмите «Основная информация» > «Команды слэша» . Нажмите «Создать новую команду» .
- В форме «Создать новую команду» укажите следующие значения:
- Команда : дайте команду косой черты. Например,
/summarize. - URL-адрес запроса : укажите полный URL-адрес развернутой нами облачной функции. Например,
https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText - Введите краткое описание, подсказку по использованию и сохраните.
- Вернитесь в «Настройки» > «Основная информация» . Нажмите «Установить приложение» , а затем нажмите « Установить в рабочую область» . Приложение будет установлено в ваше рабочее пространство.
На этом создание пользовательского приложения Slack завершено, которое теперь установлено в вашей рабочей области Slack и имеет специальную косую черту ( /summarize ), которая помогает пользователю суммировать текст, который он предоставляет в сообщении.
6. Проверьте команду «Слэш»
- Перейдите в рабочую область Slack, где вы установили приложение Slack для суммирования:
Перейдите на https://slack.com/intl/en-in/workspace-signin и введите «Найти свои рабочие области», чтобы узнать имя своей рабочей области. Выберите это.
- В чате введите текст с префиксом косой черты « /summarize ». Пример вызова показан ниже:
- Нажмите кнопку «Отправить» , чтобы вызвать функцию облака и отобразить ответ суммирования, как показано ниже:
7. Очистка
Чтобы избежать списания средств с вашей учетной записи Google Cloud за ресурсы, используемые в этом посте, выполните следующие действия:
- В консоли Google Cloud перейдите на страницу «Управление ресурсами» .
- В списке проектов выберите проект, который хотите удалить, и нажмите «Удалить».
- В диалоговом окне введите идентификатор проекта, а затем нажмите «Завершить работу» , чтобы удалить проект.
- Если вы хотите сохранить свой проект, пропустите вышеуказанные шаги и удалите функцию облака, перейдя к функциям облака и в списке функций отметьте ту, которую хотите удалить, и нажмите УДАЛИТЬ.
8. Поздравления
Поздравляем! Вы успешно создали службу суммирования текста в приложении Slack.