Bottutorial - Laravel Bluesky - Knowledge of Laravel

Overzicht

Deze pagina is de Laravel-versie van de officiële AT Protocol-bottutorial. We laten zien hoe je de op TypeScript gerichte inhoud implementeert in PHP/Laravel met het laravel-bluesky-pakket. In de officiële tutorial download je met het lex-commando telkens Lexicon-bestanden, maar laravel-bluesky heeft alle Lexicons al vooraf opgenomen via atproto-lexicon-contracts, dus die stap is niet nodig. Met Artisan-commando’s en de methodes van de HasShortHand-trait kun je vrijwel alle operaties uitvoeren.

Vereisten

Het laravel-bluesky-pakket is geïnstalleerd
Je hebt een Bluesky-account en een app password klaarstaan

Zie Laravel Bluesky voor de installatie-instructies.

BLUESKY_IDENTIFIER=yourbot.bsky.social
BLUESKY_APP_PASSWORD=xxxx-xxxx-xxxx-xxxx

Deel 1: basisbot (posten)

Een Artisan-commando maken

Maak met php artisan make:command een commando voor de bot.

php artisan make:command BotPostCommand

Bewerk het gegenereerde bestand app/Console/Commands/BotPostCommand.php.

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Revolution\Bluesky\Facades\Bluesky;

class BotPostCommand extends Command
{
    protected $signature = 'bot:post';

    protected $description = 'Post to Bluesky';

    public function handle(): void
    {
        Bluesky::login(
            identifier: config('bluesky.identifier'),
            password: config('bluesky.password'),
        )->post('🙂');

        $this->info('Posted successfully.');
    }
}

Handmatig uitvoeren

php artisan bot:post

Automatisch uitvoeren via taakplanning

Voeg de configuratie voor periodieke uitvoering toe aan routes/console.php.

use Illuminate\Support\Facades\Schedule;

// Elke 3 uur posten
Schedule::command('bot:post')->everyThreeHours();

Om de scheduler te activeren stel je het volgende in via cron.

* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

Automatisch uitvoeren met GitHub Actions

Heb je geen server, dan kun je ook automatisch uitvoeren via GitHub Actions.

# .github/workflows/bot.yml
name: Bot Post

on:
  schedule:
    - cron: '0 */3 * * *'  # Elke 3 uur
  workflow_dispatch:

jobs:
  post:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: shivammathur/setup-php@v2
        with:
          php-version: '8.4'
      - run: composer install --no-dev --optimize-autoloader
      - run: php artisan bot:post
        env:
          BLUESKY_IDENTIFIER: ${{ secrets.BLUESKY_IDENTIFIER }}
          BLUESKY_APP_PASSWORD: ${{ secrets.BLUESKY_APP_PASSWORD }}

Registreer BLUESKY_IDENTIFIER en BLUESKY_APP_PASSWORD als secrets in GitHub Actions.

Deel 2: replybot (mentions monitoren)

We maken een bot die automatisch reageert op mentions. We laten ook een voorbeeld zien waarbij AI de reply genereert.

Notificaties ophalen en op mentions reageren

php artisan make:command BotReplyCommand

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Post;
use Revolution\Bluesky\Types\ReplyRef;
use Revolution\Bluesky\Types\StrongRef;

class BotReplyCommand extends Command
{
    protected $signature = 'bot:reply';

    protected $description = 'Reply to mentions on Bluesky';

    public function handle(): void
    {
        Bluesky::login(
            identifier: config('bluesky.identifier'),
            password: config('bluesky.password'),
        );

        $notifications = Bluesky::listNotifications(limit: 20)->json('notifications', []);

        foreach ($notifications as $notification) {
            // Alleen mention-notificaties verwerken
            if (data_get($notification, 'reason') !== 'mention') {
                continue;
            }

            // Gelezen notificaties overslaan (waar isRead true is, is al verwerkt)
            if (data_get($notification, 'isRead')) {
                continue;
            }

            $uri = data_get($notification, 'uri');
            $cid = data_get($notification, 'cid');

            if (! $uri || ! $cid) {
                continue;
            }

            $ref = StrongRef::to(uri: $uri, cid: $cid);
            $reply = ReplyRef::to(root: $ref, parent: $ref);

            $post = Post::create('Hallo! Bedankt voor de mention. 🙂')
                ->reply($reply);

            Bluesky::post($post);

            $this->info("Replied to: {$uri}");
        }

        // Notificaties als gelezen markeren
        Bluesky::updateSeenNotifications(now()->toISOString());
    }
}

Als de root van de thread afwijkt, haal dan met app.bsky.feed.getPostThread de threadinformatie op en stel die in als root. In deze eenvoudige implementatie behandelen we de bovenliggende post als root.

Polling inplannen

// routes/console.php
use Illuminate\Support\Facades\Schedule;

Schedule::command('bot:reply')->everyFiveMinutes();

Replies genereren met AI

Door het laravel/ai-pakket te combineren met de laravel-amazon-bedrock-driver kun je AI-replies genereren die zijn afgestemd op de inhoud van de mention.

composer require laravel/ai revolution/laravel-amazon-bedrock

Maak een AI-agent.

<?php

namespace App\Ai\Agents;

use Laravel\Ai\Contracts\Agent;
use Laravel\Ai\Promptable;

class BotReplyAgent implements Agent
{
    use Promptable;

    public function instructions(): string
    {
        return 'Je bent een vriendelijke bot die actief is op Bluesky. '
            . 'Genereer op berichten van gebruikers een korte, vriendelijke reply in het Nederlands. '
            . 'Houd de reply binnen 200 tekens.';
    }
}

Gebruik de AI-reply in het commando.

<?php

namespace App\Console\Commands;

use App\Ai\Agents\BotReplyAgent;
use Illuminate\Console\Command;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Post;
use Revolution\Bluesky\Types\ReplyRef;
use Revolution\Bluesky\Types\StrongRef;

class BotReplyCommand extends Command
{
    protected $signature = 'bot:reply';

    protected $description = 'Reply to mentions on Bluesky using AI';

    public function handle(): void
    {
        Bluesky::login(
            identifier: config('bluesky.identifier'),
            password: config('bluesky.password'),
        );

        $notifications = Bluesky::listNotifications(limit: 20)->json('notifications', []);

        foreach ($notifications as $notification) {
            if (data_get($notification, 'reason') !== 'mention') {
                continue;
            }

            if (data_get($notification, 'isRead')) {
                continue;
            }

            $uri = data_get($notification, 'uri');
            $cid = data_get($notification, 'cid');
            $mentionText = data_get($notification, 'record.text', '');

            if (! $uri || ! $cid) {
                continue;
            }

            // Reply genereren met AI
            $replyText = (new BotReplyAgent)->prompt($mentionText)->text;

            $ref = StrongRef::to(uri: $uri, cid: $cid);
            $reply = ReplyRef::to(root: $ref, parent: $ref);

            $post = Post::create($replyText)->reply($reply);

            Bluesky::post($post);

            $this->info("AI replied to: {$uri}");
        }

        Bluesky::updateSeenNotifications(now()->toISOString());
    }
}

Zie Amazon Bedrock-driver voor de configuratie van laravel-amazon-bedrock.

Deel 3: labelbot

Dit komt overeen met labelAsBot uit de officiële tutorial. We kennen een zelflabel toe aan het profiel van het botaccount om duidelijk te maken dat het een geautomatiseerd account is.

Het labelen voer je één keer uit bij de eerste setup. We implementeren dit als een apart commando, onafhankelijk van de commando’s uit deel 1 en 2.

Het labelbotcommando maken

php artisan make:command BotLabelCommand

<?php

namespace App\Console\Commands;

use Illuminate\Console\Command;
use Revolution\Bluesky\Facades\Bluesky;
use Revolution\Bluesky\Record\Profile;
use Revolution\Bluesky\Types\SelfLabels;

class BotLabelCommand extends Command
{
    protected $signature = 'bot:label';

    protected $description = 'Add bot self-label to the Bluesky profile';

    public function handle(): void
    {
        Bluesky::login(
            identifier: config('bluesky.identifier'),
            password: config('bluesky.password'),
        )->upsertProfile(function (Profile $profile) {
            // Het !bot-label instellen
            $profile->labels(SelfLabels::make(['!bot']));
        });

        $this->info('Bot label applied successfully.');
    }
}

Uitvoeren

php artisan bot:label

Voer dit commando slechts één keer uit bij de eerste setup van de bot. Het label wordt permanent opgeslagen in het profiel.

!bot is een standaard zelflabel van Bluesky. Het wordt sterk aanbevolen om dit altijd in te stellen voor botaccounts.

Over de andere officiële tutorials

De officiële AT Protocol-tutorials behandelen nog een aantal andere onderwerpen. Hier vind je een overzicht van de ondersteuning in laravel-bluesky.

Custom feeds

In Feed Generator wordt uitgebreid uitgelegd hoe je een custom feedgenerator implementeert met Laravel.

OAuth-authenticatie

In Socialite wordt uitgelegd hoe je OAuth-authenticatie implementeert met Laravel Socialite. Dat is eenvoudiger dan in de officiële tutorial.

Sociale app (statusphere)

Er is een Laravel-versie van statusphere gepubliceerd als invokable/statusphere. Omdat deze gebaseerd is op een oudere statusphere die de commando’s lex en tap niet gebruikt, wijkt hij op enkele punten af van de nieuwste officiële tutorial.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Bottutorial - Laravel Bluesky

Overzicht

Vereisten

Deel 1: basisbot (posten)

Een Artisan-commando maken

Handmatig uitvoeren

Automatisch uitvoeren via taakplanning

Automatisch uitvoeren met GitHub Actions

Deel 2: replybot (mentions monitoren)

Notificaties ophalen en op mentions reageren

Polling inplannen

Replies genereren met AI

Deel 3: labelbot

Het labelbotcommando maken

Uitvoeren

Over de andere officiële tutorials

Custom feeds

OAuth-authenticatie

Sociale app (statusphere)

Referenties

​Overzicht

​Vereisten

​Deel 1: basisbot (posten)

​Een Artisan-commando maken

​Handmatig uitvoeren

​Automatisch uitvoeren via taakplanning

​Automatisch uitvoeren met GitHub Actions

​Deel 2: replybot (mentions monitoren)

​Notificaties ophalen en op mentions reageren

​Polling inplannen

​Replies genereren met AI

​Deel 3: labelbot

​Het labelbotcommando maken

​Uitvoeren

​Over de andere officiële tutorials

​Custom feeds

​OAuth-authenticatie

​Sociale app (statusphere)

​Referenties

Overzicht

Vereisten

Deel 1: basisbot (posten)

Een Artisan-commando maken

Handmatig uitvoeren

Automatisch uitvoeren via taakplanning

Automatisch uitvoeren met GitHub Actions

Deel 2: replybot (mentions monitoren)

Notificaties ophalen en op mentions reageren

Polling inplannen

Replies genereren met AI

Deel 3: labelbot

Het labelbotcommando maken

Uitvoeren

Over de andere officiële tutorials

Custom feeds

OAuth-authenticatie

Sociale app (statusphere)

Referenties