SpeedyBot

Appearance

[QUICKSTART] 🔥 Prompt your user for location information ​

  • What if we could ask users for location in a respectful, privacy-protecting manner?

  • This pattern already exists on mobile devices, it should exist on conversational interfaces too, ex:

Note: The steps below assume you have a working WebEx account + a Cloudflare account with permission to create Workers-- you can port this to any other infrastructure where you can expose a /location route that exposes privacy-respecting coarse-grained location information

1) Fetch repo & install deps ​

git clone https://github.com/valgaze/speedybot
cd speedybot/examples/location
npm i

2) Get + Set your bot access token ​

3) Get your bot's URL ​

  • If you don't have one already, get a cloudflare account

  • Authenticate your machine with npx wrangler login

  • Run the command to deploy the code in this repo to your Worker and get your bot URL

npm run deploy

You'll be prompted to open your browser and you'll see an authorization screen like the following asking to enable wrangler (Worker's CLI tool) to take actions with your account, click ALLOW

The URL will look something like https://speedybot-worker-infra.your_username.workers.dev (you'll need it in a minute when we register webhooks)

4) Add your bot token ​

From the same directory as the repo run the following command to add a secret called BOT_TOKEN and enter your info using secrets manager

sh
npx wrangler secret put BOT_TOKEN

5) Add your encryption secret ​

Just like the last step add a secret called CRYTPO_SECRET to the environment. This value can be whatever you want so long as it's a random value and you keep it a secret

npx wrangler secret put CRYPTO_SECRET

6) Deploy your agent ​

From the same directory as the repo run this command to deploy your agent (now bound with your BOT_TOKEN secret)

npm run deploy

7) Register your webhooks ​

  • Right now if you try to interact with your "deployed" agent nothing happens, nobody is "home" to answer the knock at the door

  • Make a note of the URL of the deployed function (ie https://speedybot-worker-infra.your_username.workers.dev)

  • Hop on over to the SpeedyBot Garage (https://speedybot.js.org/garage), enter your access token, select the Webhooks tab, and then Add New Webhook and add your Worker's URL and (optionally) a webhook secret

7a) Supply your Webhook "secret" to your Worker ​

Even though it's "optional", it's a really, really good idea to set a Webhook Secret too so you can make sure incoming requests are the real deal. For more detail, see https://speedybot.js.org/webhooks#securing-webhooks

To supply your Worker with a webhook secret, set a secret called WEBHOOK_SECRET which you'll need to supply to your Worker like you did with your BOT_TOKEN value

sh
npx wrangler secret put WEBHOOK_SECRET

8) Take it for a spin ​

  • After connecting webhooks, take it for a spin + say "location" or tap the Location Integration chip:

Some notes ​

  • This is a proof of concept where the location-enriched functionality is broken out into a separate file

  • The service used in this instance gives at best a very rough/coarse-grained amount of detail of a user's "location"-- the less detail your agent needs, the better