Beginner Bird - Je eerste Bird stap voor stap bouwen

Om een expert vogelkijker te worden moet je ergens beginnen. Deze gids is voor Blackbird-beginners en brengt je op de hoogte van de basisprincipes van het bouwen van birds.

Deze gids leert je de algemene aanpak voor elke workflow die je wilt automatiseren met Blackbird. We doen dit stap voor stap, dus we moedigen je aan om mee te doen met je eigen Blackbird-account! We gebruiken de Slack, DeepL en OpenAI apps. Wanneer je wordt gevraagd om inloggegevens, kun je in de bijbehorende documentatiesecties bekijken hoe je verbinding maakt. Je kunt natuurlijk ook alternatieven voor deze apps gebruiken, bijvoorbeeld Amazon Translate in plaats van DeepL.

Aan het einde van deze gids heb je een Slack-bot gebouwd die reageert op je berichten in Slack in een andere taal. Dit is volgens onze ervaring de leukste eerste bird die je kunt bouwen! Natuurlijk is het niet echt toepasbaar op echte wereld scenario’s (hoewel elementen ervan dat wel kunnen zijn). In latere gidsen leer je meer over hoe je productie-birds kunt aanpakken en hoe je lokalisatie-gerelateerde workflows kunt opzetten.

Stap 1: Een bird die een bericht verstuurt

Navigeer naar de birds-pagina en klik op de grote paarse knop Create. Dit opent de bird-editor. Je wordt begroet door het volgende scherm.

Laten we de elementen op het scherm doornemen:

• Het midden van je scherm toont de trigger, en later alle acties die worden uitgevoerd. Met het + pictogram kun je acties en andere workflow-gerelateerde stappen maken.
• De rechterkant van het scherm toont de details van je geselecteerde stap. Op dit moment is de stap New trigger geselecteerd, zodat je deze kunt configureren.
• Boven de workflow zie je de naam van je bird en een knop met 3 puntjes (…), deze knop wordt gebruikt om de metadata van de bird te beheren. Van hieruit kun je de bird hernoemen, exporteren, klonen en kopiëren. Het zal ook beschikbare updates van apps tonen als die er zijn.

Om de eenvoudigste bird mogelijk te bouwen, selecteren we Manual trigger aan de rechterkant van het scherm. Een handmatige trigger betekent dat we deze bird vanuit Blackbird kunnen triggeren door op een knop te klikken.

Nu is het tijd om onze eerste actie te definiëren. We doen dit door op het + pictogram in het midden van het scherm te klikken en Action te selecteren.

Je ziet een nieuwe actie onder je trigger. De actie is echter nog leeg en we moeten definiëren wat we willen doen met welke app en welke verbinding. Ga verder en klik op app aan de rechterkant van je scherm. Zoek naar de app waarvoor je de actie wilt toevoegen. In ons geval is dit Slack.

Na het definiëren van de app moeten we nu de actie definiëren die we willen uitvoeren. We gaan een bericht versturen in Slack, dus zoek naar Send message en selecteer het. Tot slot selecteren we de verbinding. Je kunt op Add new connection klikken als je nog geen Slack-verbinding hebt gemaakt.

Het eindresultaat zou er zo uit moeten zien:

Nu we weten wat we moeten doen, moeten we Blackbird vertellen welke informatie we willen versturen. Klik op de paarse knop Continue, of op het tabblad dat Inputs zegt.

Je acties hebben extra informatie nodig om uitgevoerd te worden. Sommige van deze informatie is vereist, sommige is optioneel. We kunnen in de onderstaande afbeelding zien dat de Channel ID een vereiste parameter is voor de actie: Blackbird wil weten naar welk kanaal het bericht moet worden verzonden.

Bij het doorgeven van informatie aan een actie moeten we ons ervan bewust zijn dat deze informatie uit een van twee plaatsen kan komen:

• Als de informatie afkomstig is van een actie of gebeurtenis die vóór deze actie plaatsvindt, dan selecteer je het toverstafpictogram voor het informatieveld. De toverstaf geeft aan dat Blackbird gegevens zal gebruiken die het resultaat waren van andere acties of gebeurtenissen tijdens de uitvoering van je workflow.
• Als de informatie statisch is en alleen wordt gedefinieerd terwijl je de bird bouwt, dan gebruiken we ofwel de dropdown of tekstinvoer.

💡 Opmerking: het verschil tussen dropdown en tekstinvoer wordt gedefinieerd in de Blackbird-app en is gebaseerd op of de informatie die legaal kan worden ingevoerd eindig is (in dat geval is er een dropdown) of oneindig (in dat geval kun je de informatie zelf typen).

Laten we de Channel ID definiëren die Blackbird van ons wil. De kanalen die mogelijke waarden zijn voor deze parameter zijn eindig en vooraf gedefinieerd. Daarom, wanneer je op Select input data klikt, zal Blackbird je daadwerkelijk de kanalen tonen die beschikbaar zijn voor jou vanuit de verbinding!

Je kunt typen in het zoekvak om je zoekopdracht te verfijnen. Selecteer een kanaal dat je wilt gebruiken voor deze bird, in ons geval gaan we gewoon het kanaal #general selecteren.

We hebben gedefinieerd naar welk kanaal het bericht moet worden verzonden, geweldig! Nu moeten we Blackbird ook vertellen welk bericht we willen versturen. Klik op Add input om een dropdown te zien van alle mogelijke optionele inputs. Selecteer Message. Typ nu een bericht dat je wilt versturen. In ons geval gaan we Hello from Blackbird! versturen. Je kunt elk bericht typen dat je wilt (aangegeven door het toetsenbordpictogram).

💡 Opmerking: In Slack is het niet mogelijk om een bericht te versturen zonder een daadwerkelijke berichttekst of een bijlage. De reden dat het bericht nog steeds optioneel is, is omdat je ook een bijlage zou kunnen versturen zonder een begeleidende tekst.

Je actie zou er nu ongeveer zo uit moeten zien:

Dat is het! Nu is het tijd om je eerste bird te laten vliegen. Je doet dit door op de paarse Fly knop bovenaan het scherm te klikken.

Je zou bijna direct het bericht in je Slack-kanaal moeten zien!

Het is nu ook mogelijk om de uitvoering van deze bird in Blackbird te verifiëren. We doen dit door op Show Flights naast de fly-knop te klikken. Je ziet een lijst met flights. Door op een flight te klikken kun je elke gebeurtenis en actie die is uitgevoerd inspecteren. Door op een actie te klikken kun je ook de input- en outputwaarden zien die werden doorgegeven.

Stap 2: Een vertaling versturen

Laten we een tweede stap aan de bird toevoegen. We willen eerst een zin vertalen met DeepL, en dan de vertaling naar ons Slack-kanaal sturen. Om dit te doen, moeten we een nieuwe actie toevoegen. Deze actie moet vóór we het bericht naar Slack sturen gebeuren. Daarom maken we een nieuwe actie tussen de trigger en Send message. Klik op het + pictogram en selecteer opnieuw actie.

Deze keer selecteren we niet Slack als onze app maar DeepL. Selecteer vervolgens de actie Translate en je verbinding (maak er een aan als je er nog geen hebt). Je scherm zou er dan zo uit moeten zien:

Het is tijd om de informatie weer in te vullen door op Continue te klikken. Deze keer zijn twee velden vereist: Text en Target language. We zijn vrij om elke tekst te typen die we willen, we zien ook dat Target language ons een dropdown zal presenteren. Vul een tekst in om te vertalen en selecteer een doeltaal, in dit geval gaan we voor Hello from Blackbird! en Spanish.

💡 Opmerking: Bij het inspecteren van de optionele waarden zien we dat DeepL veel meer informatie kan opnemen, voel je vrij om deze opties te verkennen!

We zijn bijna klaar om te vliegen. Bijna, want nu komt het belangrijkste deel! We kunnen verwachten dat DeepL ons een vertaling terugstuurt, we moeten nu Blackbird vertellen om die vertaling te nemen en in ons Slack-bericht te sturen.

We doen dit door terug te gaan naar onze Send message actie door erop te klikken. Je ziet dat het bericht dat we versturen nog steeds het bericht is dat we eerder hebben getypt. Weet je nog dat toverstafpictogram? Laten we het nu gebruiken!

Klik op de toverstaf voor het veld Message. Het invoerveld verandert nu in een dropdown. Klik op de dropdown en je krijgt de informatie te zien die van DeepL terugkomt.

Je merkt misschien op dat Blackbird je ook waarschuwt dat je workflow onvolledig is. Laten we snel op Translated text klikken, want dat is de informatie die we van DeepL naar Slack willen sturen. Nadat je dit hebt gedaan, zou alles er goed uit moeten zien en is het tijd om opnieuw op de Fly knop te klikken!

🥳 ¡Felicidades! Je hebt zojuist een bird gemaakt die het belangrijkste aspect van Blackbird demonstreert: informatie van de ene applicatie nemen en doorgeven aan de andere. Voel je vrij om nogmaals op Show Flights te klikken om alle informatie over de flight te zien. Ben je na dat gedaan te hebben klaar om het naar een hoger niveau te tillen?

Stap 3: Reageren op een bericht

Tot nu toe hebben we deze bird getriggerd door op de Fly knop te klikken. Zou het niet veel leuker zijn als deze bird daadwerkelijk triggert op berichten die in Slack worden verzonden? Het is tijd om deze handmatige trigger te veranderen. Wat we willen bereiken is dat als iemand een bericht naar een kanaal stuurt terwijl hij @Blackbird tagt, deze bird zal vliegen en het bericht voor je zal vertalen.

Laten we beginnen door op de Manual trigger te klikken. Aan de rechterkant kunnen we deze nu veranderen in een Event trigger. Event trigger betekent altijd dat we triggeren op basis van dingen die in verbonden applicaties gebeuren.

In tegenstelling tot de handmatige trigger vereist de event trigger wel wat configuratie. Nadat je op Continue hebt geklikt, krijg je een vertrouwd menu te zien. Het is tijd om de app, gebeurtenis en verbinding te selecteren. Voor app selecteer je Slack en voor de gebeurtenis selecteer je On app mentioned

⚠️ Waarschuwing: je bent misschien geneigd om de gebeurtenis on message te gebruiken. Dit zou echter een vergissing zijn, aangezien we tijdens deze bird ook een bericht terug naar Slack gaan sturen, wat op zijn beurt weer de bird zou triggeren. Dat is een oneindige lus! Je zult merken dat je bewust zijn van scenario’s zoals deze het daadwerkelijk moeilijke deel van Solution architecting gaat worden.

Als we de bird zo zouden publiceren, zou Blackbird reageren op elk bericht waarin het getagd wordt in elk kanaal. Als je wilt dat Blackbird alleen naar een specifiek kanaal luistert, klik dan op Inputs en selecteer een kanaal voor Channel ID.

Nu we de trigger hebben veranderd in een gebeurtenis, zien we de Fly knop niet meer. In plaats daarvan zien we Save en na het klikken op Save zien we Publish.

Ga verder en klik op Publish. Achter de schermen neemt Blackbird nu contact op met Slack en vertelt het dat Slack Blackbird moet informeren wanneer een gebruiker een bericht stuurt waarin het wordt vermeld.

Laten we het in actie zien! Ga naar je kanaal en stuur een bericht waarin je @Blackbird tagt.

💡 Opmerking je hebt misschien in de Slack-documentatie gelezen dat voor events de Slack-app moet worden toegevoegd aan een kanaal. Je kunt dit doen via het Slack-kanaalmenu, of door een bericht te sturen met @Blackbird, Slack zal je dan vragen of je de app aan dat kanaal wilt toevoegen. Ga akkoord.

Oeps! Je ziet dat we de bird hebben veranderd om te triggeren wanneer we een bericht sturen dat @Blackbird bevat. Het doet echter nog niet wat we