Ctrlk
Build with Riff
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Quickstart: Agent

Get a Monday‑morning email with 5 hand‑picked articles matched to your interests, job, and reading style - fully automated.

You'll get an agent that searches the web, scores relevance using your criteria, and sends you a personalized digest. No feeds. No noise.

Perfect for: Knowledge workers drowning in newsletters, operators who need signal over noise, anyone building domain expertise.

Features

  • Personalized search: Agent decides which sources to search based on your topics

  • Smart filtering: Scores articles against your job context and values

  • Autonomous scheduling: Runs every Monday at 07:00 without you

  • Slack delivery: Digest arrives in your Slack channel with article summaries

Create your news digest agent

1

Step 1 - Create an account

Go to riff.ai and sign up.

2

Step 2 - Describe your agent

Paste this into the prompt box:

Build a personalised newsletter agent that uses OpenAI and Tavily MCP to search the internet for latest news and insights from my preferences. Compiling a daily newsletter that will be summarised and sent to Slack.

3

Step 3 - Confirm the plan → Build

Riff will generate a Riff Card — the build plan. Review it. Adjust if needed. Click Confirm plan → Build project.

4

Step 4 - Complete the tasks

Your workspace is live.

You'll see a preview tab, this is the interface the agent has designed for your app.

Note: This is a placeholder interface and will not function at this stage.

The agent creates a task list and runs until it needs input. Click on the Tasks tab to see the plan the agent has created to complete your application.

Note: your tasks may look different.

  • Task 1 is already complete as the agent has created a user interface page.

  • Task 2 will typically be to set up your integrations for OpenAI, Tavily and Slack.

  • Task 3 create a backend for your app, this will be the process that will run. In this case, it will be searching and summarizing relevant content.

  • Task 4 is to make your personalise your agent search. In this case, the agent will:

    • Create an interface for you to enter your content

    • Set up the database to store and retrieve your content preferences.

  • Tasks 5 & 6 create the schedule to trigger the process and deliver the outputs to Slack.

The agent will ask for your OpenAI API key and your Tavily MCP key.

5

Step 5 - Test your agent

Click "Run now" to trigger the agent manually.

Check your Slack channel. You should receive a digest with 5 articles, scored and summarized based on your criteria.

Not relevant enough? Tell the agent in plain English:

  • "Make the 'practical insights' filter stricter"

  • "Ignore anything from corporate blogs"

  • "Add 'AI regulation' as a topic"

The agent updates its logic. Test again.

6

Step 6 - Deploy

When it looks right: Deploy → choose a short URL → Deploy app.

Your agent now runs autonomously every Monday at 07:00. You can share the URL with teammates to build their own personalized digests.

7

Well done!

You've built an autonomous agent that researches, evaluates, and reports — without you lifting a finger!

Get your Open AI API key

  1. Create an OpenAI Account:

  • Visit the OpenAI platform website and click on Sign Up if you don't have an account. You can also log in using your Google or Microsoft account if you prefer.

  1. Log In:

  • If you already have an account, click on Log In and enter your credentials.

  1. Access the API Keys Section:

  • Once logged in, click on your profile icon at the top-right corner of the page and select View API Keys from the dropdown menu.

  1. Create a New API Key:

  • On the API keys page, click on the Create New Secret Key button. This will generate a new API key for you.

Get your Tavily API Key

To obtain your Tavily API key, follow these steps:

  • Go to the Tavily website (https://tavily.com/) and log in to your account. If you don’t have an account, sign up first.

  • Navigate to the API section at https://app.tavily.com/home. Your API Key will be displayed in the “API Keys” section.

  • If you need to create an additional API key, click on the "+" button next to the API keys section in your dashboard.

  • You receive free API Credits every month, which allows for personal use and experimentation.

Tip:

Last updated

Was this helpful?