1. Introduction
Dans cet atelier de programmation, vous trouverez des instructions pour créer un service de synthèse dans un espace de travail Slack en intégrant la commande Slash Slack.
L'utilisateur appelle une commande Slash /summarize et saisit le texte à résumer. Ensuite, l'application Slack appelle la fonction Cloud associée qui accepte le texte et appelle l'API PaLM pour la synthèse. Le texte résumé est ensuite renvoyé à la commande Slack Slash et affiché en tant que réponse dans l'application Slack.
pour en savoir plus. Voici la liste des services Google Cloud utilisés:
- Cloud Functions
- API Vertex AI PaLM
- Cloud Logging
Ce que vous allez faire
Vous allez créer
- Fonction Cloud qui appelle l'API PaLM pour la synthèse de texte provenant de Slack à l'aide de la commande Slash
- Application Slack qui appelle la fonction Cloud ci-dessus à des fins de synthèse.
2. Conditions requises
3. Avant de commencer
- Dans la console Google Cloud, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.
- Assurez-vous que la facturation est activée pour votre projet Google Cloud. Découvrez comment vérifier si la facturation est activée sur un projet.
- Assurez-vous que les API Cloud Functions et Vertex AI sont activées.
- Activez Cloud Shell depuis la console Google Cloud en suivant ces instructions.
- Si votre projet n'est pas défini, utilisez la commande suivante pour le définir :
gcloud config set project <YOUR_PROJECT_ID>
- Dans Cloud Shell, définissez les variables d'environnement suivantes:
export GCP_PROJECT=<YOUR_PROJECT_ID>
export GCP_REGION=us-central1
4. Déployer la fonction Cloud Functions
Pour créer et déployer des fonctions Cloud, procédez comme suit:
- Clonez le code du dépôt https://github.com/rominirani/genai-apptemplates-googlecloud en exécutant la commande suivante dans votre terminal Cloud Shell:
git clone https://github.com/rominirani/genai-apptemplates-googlecloud
- Cette commande clone le contenu du dépôt dans le dossier genai-templates-googlecloud.
- Accédez au dossier du projet qui vous intéresse en exécutant la commande suivante depuis le terminal Cloud Shell:
cd genai-apptemplates-googlecloud/summarization-slack
- Vous devriez voir les fichiers main.py et requirements.txt dans le dossier "summarization-hash" en exécutant la commande dir ou en accédant à l'éditeur Cloud Shell.
- Pour déployer la fonction Cloud, exécutez la commande gcloud functions deploy:
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
Une fois la fonction Cloud déployée, son URL s'affiche dans le terminal Cloud Shell. L'URL est au format suivant:
https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText
Notez l'URL affichée. Vous en aurez besoin pour créer la commande Slack Slash.
5. Créer la commande Slack Slash
Créons une commande Slash personnalisée dans Slack. La commande personnalisée /summarize appelle la fonction Cloud que nous avons déployée dans la section précédente.
Pour créer une commande Slash, procédez comme suit:
- Accédez à api.slack.com/apps.
- Cliquez sur Create New App (Créer une application).
- Dans la fenêtre Créer une application, sélectionnez l'option À partir de zéro.
- Attribuez un nom à votre application. Par exemple,
Summarization Slack Application.Sélectionnez l'espace de travail Slack pour le développement de votre application. - Cliquez sur Create App (Créer une application). La page Paramètres s'ouvre.
- Sur la page Paramètres, cliquez sur Informations générales > Commandes à barre oblique. Cliquez sur Créer une commande.
- Dans le formulaire Create New Command (Créer une commande), indiquez les valeurs suivantes:
- Commande: exécutez une commande à barre oblique. Par exemple,
/summarize.. - Request URL (URL de la requête) : indiquez l'URL complète de la fonction Cloud que nous avons déployée. Par exemple,
https://$GCP_REGION-$GCP_PROJECT.cloudfunctions.net/summarizeText. - Saisissez une brève description et un conseil d'utilisation, puis enregistrez.
- Revenez à Paramètres > Informations générales Cliquez sur Installer votre application, puis sur Installer dans Workspace. L'application est installée dans votre espace de travail.
Cette opération termine la création de l'application Slack personnalisée qui est maintenant installée dans votre espace de travail Slack et comporte une commande Slash personnalisée (/summarize) qui aide un utilisateur à résumer le texte qu'il fournit dans le message.
6. Tester la commande Slash
- Accédez à l'espace de travail Slack dans lequel vous avez installé l'application Slack de synthèse:
Accédez à https://slack.com/intl/en-in/workspace-signin et saisissez "Trouver vos espaces de travail" pour repérer le nom de votre espace de travail. Sélectionnez-la.
- Dans le chat, saisissez le texte précédé de la commande à barre oblique "/summarize". Voici un exemple d'appel:
- Cliquez sur le bouton Send (Envoyer) pour appeler la fonction Cloud et afficher la réponse de synthèse comme indiqué ci-dessous:
7. Effectuer un nettoyage
Pour éviter que les ressources utilisées dans cet article soient facturées sur votre compte Google Cloud, procédez comme suit:
- Dans la console Google Cloud, accédez à la page Gérer les ressources.
- Dans la liste des projets, sélectionnez celui que vous souhaitez supprimer, puis cliquez sur Supprimer.
- Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.
- Si vous souhaitez conserver votre projet, ignorez les étapes ci-dessus et supprimez la fonction Cloud Functions en accédant à Cloud Functions. Dans la liste des fonctions, cochez celle que vous souhaitez supprimer, puis cliquez sur SUPPRIMER.
8. Félicitations
Félicitations ! Vous venez de créer un service de synthèse de texte dans l'application Slack.