Zephyrnet-logo

Implementeer een Slack-gateway voor Amazon Q, uw bedrijfsexpert | Amazon-webservices

Datum:

Amazon Q is een nieuwe generatieve AI-aangedreven applicatie die gebruikers helpt hun werk gedaan te krijgen. Amazon Q kan uw bedrijfsexpert op maat worden en u inhoud laten ontdekken, ideeën laten brainstormen of samenvattingen maken met behulp van de gegevens van uw bedrijf, veilig en beveiligd. Je kunt Amazon Q gebruiken om gesprekken te voeren, problemen op te lossen, inhoud te genereren, inzichten te verwerven en actie te ondernemen door verbinding te maken met de informatieopslagplaatsen, code, gegevens en bedrijfssystemen van je bedrijf. Voor meer informatie, zie Introductie van Amazon Q, een nieuwe generatieve AI-aangedreven assistent (preview).

In dit bericht laten we zien hoe je het meeneemt Amazon Q, uw bedrijfsexpert, voor gebruikers in Slack.

Je kunt met Amazon Q praten via directe berichten (DM's) van Slack om vragen te stellen en antwoorden te krijgen op basis van bedrijfsgegevens, hulp te krijgen bij het maken van nieuwe inhoud zoals e-mailconcepten, bijgevoegde bestanden samen te vatten en taken uit te voeren.

Je kunt Amazon Q ook uitnodigen om deel te nemen aan je teamkanalen. In een kanaal kunnen gebruikers vragen stellen in een nieuw bericht, of het op elk gewenst moment in een bestaande thread taggen, om extra gegevenspunten te verschaffen, een debat op te lossen, of het gesprek samen te vatten en de volgende stappen vast te leggen.

Overzicht oplossingen

Amazon Q is verbazingwekkend krachtig. Bekijk de volgende demo: zien is geloven!

In de demo is onze Amazon Q-applicatie gevuld met een set AWS-whitepapers. U kunt uw eigen Amazon Q-toepassing voor bedrijfsexperts vullen met de documenten en kennisbankartikelen van uw eigen bedrijf, zodat deze uw vragen kan beantwoorden!

Alles wat je nodig hebt, wordt als open source aangeboden in onze GitHub repo.

In dit bericht begeleiden we u door het proces om Amazon Q in uw AWS-account te implementeren en toe te voegen aan uw Slack-werkruimte. Als je klaar bent, vraag je je af hoe je ooit zonder hebt gekund!

Hier volgen enkele dingen die het kan doen:

  • Reageer op berichten – In DM's reageert het op alle berichten. In kanalen reageert het alleen op @vermeldingen en reageert het in een gespreksthread.
  • Geef antwoorden weer die een prijsverlaging bevatten – Dit omvat koppen, lijsten, vetgedrukt, cursief, tabellen en meer.
  • Houd het sentiment bij – Het biedt knoppen voor duim omhoog en duim omlaag om het gebruikerssentiment te volgen.
  • Geef bronvermelding – Het biedt verwijzingen en hyperlinks naar bronnen die door Amazon Q worden gebruikt.
  • Begrijp de gesprekscontext – Het volgt het gesprek en reageert op basis van de context.
  • Blijf op de hoogte van meerdere gebruikers – Wanneer het in een discussie is getagd, weet het wie wat heeft gezegd en wanneer, zodat het in de context kan bijdragen en de discussie nauwkeurig kan samenvatten als daarom wordt gevraagd.
  • Verwerk bijgevoegde bestanden – Het kan maximaal vijf bijgevoegde bestanden verwerken voor het beantwoorden van documentvragen, samenvattingen en meer.
  • Nieuwe gesprekken starten – U kunt nieuwe gesprekken in DM-kanalen resetten en starten met behulp van /new_conversation.

Slank voorbeeld

In de volgende secties laten we zien hoe u het project kunt implementeren op uw eigen AWS-account en Slack-werkruimte, en kunt beginnen met experimenteren!

Voorwaarden

U heeft een AWS-account en een AWS Identiteits- en toegangsbeheer (IAM) rol en gebruiker met machtigingen om de benodigde resources en componenten voor deze applicatie te maken en te beheren. Als u geen AWS-account heeft, zie Hoe maak en activeer ik een nieuw Amazon Web Services-account?

Je hebt ook een bestaande, werkende Amazon Q Business Expert-applicatie nodig. Als u er nog geen hebt ingesteld, raadpleegt u Een Amazon Q-applicatie maken.

Ten slotte hebt u een Slack-account en toegang nodig om apps te maken en te publiceren in uw Slack-organisatie. Als u er geen heeft, kijk dan of uw bedrijf een Slack-sandboxorganisatie kan creëren waarmee u kunt experimenteren, of ga naar slack.com om een ​​gratis Slack-account en werkruimte aan te maken.

Implementeer de oplossingsresources

We hebben kant-en-klaar geleverd AWS CloudFormatie sjablonen die alles implementeren wat u nodig heeft in uw AWS-account.

Als u een ontwikkelaar bent en de oplossing vanuit code wilt bouwen, implementeren of publiceren, raadpleegt u de Ontwikkelaar README.

Voer de volgende stappen uit om de CloudFormation-stack te starten:

  1. Meld u aan bij de AWS-beheerconsole.
  2. Kies een van de volgende Start Stack knoppen voor de gewenste AWS-regio om de AWS CloudFormation-console te openen en een nieuwe stapel te maken.
Regio Start Stack
Noord Virginia (us-east-1)
Oregon (us-west-2)
  1. Voor Stack naam, voer een naam in voor uw app (bijvoorbeeld AMAZON-Q-SLACK-GATEWAY).
  2. Voor AmazonQAppIdVoer uw bestaande Amazon Q-applicatie-ID in (bijvoorbeeld 80xxxxx9-7xx3-4xx0-bxx4-5baxxxxx2af5). Je kunt het kopiëren vanaf de Amazon Q-console.
  3. Voor AmazonQRegionKies de regio waar je je Amazon Q-applicatie hebt gemaakt (us-east-1 of us-west-2).
  4. Voor AmazonQUserId, voer een e-mailadres van een Amazon Q-gebruikers-ID in (laat dit leeg om een ​​Slack-gebruikers-e-mailadres als gebruikers-ID te gebruiken).
  5. Voor ContextDagenToLive, voer de tijdsduur in waarin metagegevens van gesprekken in de cache worden bewaard Amazon DynamoDB (je kunt dit als standaard laten staan).

Wanneer uw CloudFormation-stackstatus is CREATE_COMPLETE, kies de Uitgangen tabblad en houd het open. Je hebt het in latere stappen nodig.

Maak je app

Nu kunt u uw app in Slack maken. Voer de volgende stappen uit:

  1. Maak een Slack-app in https://api.slack.com/apps uit het gegenereerde manifest: kopieer en plak vanuit de stapeluitvoer: SlackAppManifest.
  2. Kies Startpagina app in het navigatievenster en blader omlaag naar de sectie Tabbladen weergeven.
  3. Enable Tabblad Berichten.
  4. kies Sta gebruikers toe Slash-opdrachten en berichten te verzenden vanaf het tabblad Berichten.

Dit is een vereiste stap zodat uw gebruiker berichten naar uw app kan sturen.

Slack-inschakelberichten

Voeg uw app toe aan uw werkruimte

Nu kunt u uw app toevoegen aan uw werkruimte. Dit is vereist om de OAuth-tokenwaarde van de botgebruiker te genereren die nodig is in de volgende stap.

  1. Ga naar OAuth en machtigingen (In https://api.slack.com) en kies Installeren in werkruimte om het OAuth-token te genereren.
  2. Ga in Slack naar uw werkruimte.
  3. Kies de naam van uw werkruimte, Instellingen & beheer en Beheer apps.
  4. Kies uw nieuw gemaakte app.
  5. Kies in het rechterdeelvenster Openen in App-directory.
  6. Kies Openen in Slack.

Configureer Slack-geheimen in AWS Secrets Manager

Laten we uw Slack-geheimen configureren om de handtekening van elk verzoek te verifiëren en namens uw Amazon Q-bot te posten.

In dit voorbeeld schakelen we Slack-tokenrotatie niet in. U kunt dit inschakelen voor een productie-app door rotatie te implementeren via AWS-geheimenmanager. Maak een issue (of, beter nog, een pull-request) in het GitHub repo als u deze functie aan een toekomstige versie wilt toevoegen.

Voer de volgende stappen uit om een ​​geheim in Secrets Manager te configureren:

  1. Navigeer op de AWS CloudFormation-console naar uw stapel Uitgangen tabblad en kies de link voor SlackSecretConsoleUrl om te worden doorgestuurd naar de Secrets Manager-console.
  2. Kies Haal geheime waarde op.
  3. Kies Edit.
  4. Vervang de waarden van SlackSigningSecret en SlackBotUserOAuthToken met behulp van de waarden in de Slack-applicatieconfiguratie onder Algemene informatie en OAuth en machtigingen.

Pas op dat u niet per ongeluk kopieert Cliëntgeheim in plaats van Ondertekening geheim.

Geheimen bewerken

Begin met het gebruiken van Amazon Q

Voer de volgende stappen uit om Amazon Q in Slack te gaan gebruiken:

  1. Open uw Slack-werkruimte.
  2. Onder Apps, Beheren, voeg je nieuwe Amazon Q-app toe.
  3. Voeg optioneel uw Amazon Q-app toe aan teamkanalen.
  4. Voer in het DM-kanaal van de app in Hello.

Zeg hallo

U hebt nu een krachtige nieuwe AI-assistent in uw sandbox Slack-omgeving geïmplementeerd.

Speel ermee, probeer alle functies die in dit bericht worden besproken en kopieer de dingen die je in de demovideo hebt gezien. Het belangrijkste is dat u vragen kunt stellen over onderwerpen die verband houden met de documenten die u in uw eigen Amazon Q Business Expert-applicatie hebt opgenomen. Maar stop daar niet. U kunt aanvullende manieren vinden om het nuttig te maken, en als u dat doet, kunt u ons dit laten weten door een reactie te plaatsen.

Zodra u ervan overtuigd bent hoe nuttig het is, praat dan met uw Slack-beheerders (en laat hen dit bericht zien) en werk met hen samen om het in de Slack-werkruimten van uw bedrijf te implementeren. Uw collega’s zullen u dankbaar zijn!

Opruimen

Wanneer u klaar bent met experimenteren met deze oplossing, verwijdert u uw app in Slack (https://api.slack.com/apps) en ruim uw AWS-bronnen op door de AWS CloudFormation-console te openen en de AMAZON-Q-SLACK-GATEWAY stapel die u hebt ingezet. Hiermee worden de resources verwijderd die u hebt gemaakt door de oplossing te implementeren.

Conclusies

Dit voorbeeld van een Amazon Q Slack-applicatie die in dit bericht wordt besproken, wordt geleverd als open source. Je kunt het gebruiken als uitgangspunt voor je eigen oplossing, en ons helpen deze te verbeteren door back-fixes en functies bij te dragen via GitHub-pull-verzoeken. Ontdek de code, kies Bekijk de introductievideo in de GitHub repo om op de hoogte te blijven van nieuwe releases en kom regelmatig terug voor de nieuwste updates. We horen ook graag uw suggesties voor verbeteringen en functies.

Voor meer informatie over Amazon Q raadpleegt u Wat is Amazon Q (voor zakelijk gebruik)?


Over de auteurs

Gary Benattar is een Senior Software Development Manager bij AWS HR. Gary begon in 2012 bij Amazon als stagiair en richtte zich op het bouwen van schaalbare, realtime systemen voor het detecteren van uitschieters. Hij werkte in Seattle en Luxemburg en is nu gevestigd in Tel Aviv, Israël, waar hij zijn tijd wijdt aan het bouwen van software die een revolutie teweeg zal brengen in de toekomst van Human Resources. Hij was mede-oprichter van een startup, Zengo, met een focus op het beveiligen van digitale portemonnees door middel van berekeningen met meerdere partijen. Hij behaalde zijn MSc in Software Engineering aan de Sorbonne Universiteit in Parijs.


Bob Strahan

Bob Strahan is een Principal Solutions Architect in het AWS Language AI Services-team.

spot_img

Laatste intelligentie

spot_img