# Riff

## Riff Docs

- [Welcome to Riff](https://docs.riff.ai/welcome-to-riff-v2.md): Riff gives your procurement and operations teams working AI agents — teammates that connect directly to your ERP, take action on your behalf, and keep a full audit trail of everything they do.
- [What you can build with Riff](https://docs.riff.ai/get-started/what-you-can-build-with-riff-v2.md): Apps and Agents — understand which build type fits your procurement or operations job before you start.
- [Build your first app](https://docs.riff.ai/get-started/quickstart-dashboard-v2-v2.md)
- [Build your first agent](https://docs.riff.ai/get-started/quickstart-agent-v2.md)
- [Source-to-Pay](https://docs.riff.ai/use-cases/source-to-pay.md): Use cases covering the full journey from supplier selection and purchase requisition through to invoice payment and AP close. For procurement, AP, and operational finance teams.
- [Plan-to-Produce](https://docs.riff.ai/use-cases/plan-to-produce.md): Use cases covering demand forecasting, inventory management, production scheduling, and product lifecycle. For planning, supply chain, and operations teams.
- [Order-to-Cash](https://docs.riff.ai/use-cases/order-to-cash.md): Use cases covering order handling, quoting, configuration, shipping, and sales performance. For sales operations, customer service, and commercial finance teams.
- [ESG & Regulatory](https://docs.riff.ai/use-cases/esg-and-regulatory.md): Use cases covering emissions reporting, trade compliance, supplier screening, and regulatory filings. For ESG, compliance, trade, and supply chain teams.
- [Cross-functional](https://docs.riff.ai/use-cases/cross-functional.md): Use cases that span multiple business functions or support internal operations — productivity tools, internal workflows, and platform-level visibility.
- [Team Workspace](https://docs.riff.ai/reference/team-workspace.md): The Team Workspace is the shell you see after logging in to Riff. It is shared across your whole team and gives you a single place to reach all your apps, agents, and team-level resources.
- [Home](https://docs.riff.ai/reference/team-workspace/home.md)
- [Ask Riff](https://docs.riff.ai/reference/team-workspace/ask-riff.md): Ask Riff is a persistent, threaded chat with the Riff agent at team level — available from the left sidebar of the Team Workspace.
- [Context](https://docs.riff.ai/reference/team-workspace/context.md): Context is your team's knowledge library — information the Riff agent draws on when helping you build and when your agents run their jobs.
- [App builder](https://docs.riff.ai/reference/app-builder.md): The App builder is where you build user-facing applications — dashboards, forms, portals, and tools that your team or customers open and use.
- [Preview](https://docs.riff.ai/reference/app-builder/preview.md): Preview shows your app running live inside the App builder. Use it to test your work in real time as you build.
- [Tasks](https://docs.riff.ai/reference/app-builder/tasks.md): Tasks is the shared task board between you and the Riff agent. See what is in progress, what is queued, and what has been completed.
- [Riff agent chat](https://docs.riff.ai/reference/app-builder/riff-agent-chat.md): The Riff agent chat panel runs on the right side of the App builder. This is where you direct the Riff agent to build, change, and fix your app.
- [Code Editor](https://docs.riff.ai/reference/app-builder/code-editor.md): The Code Editor gives you a direct view of every source file in your app. Use it to inspect what the Riff agent has built or make changes the agent cannot handle through prompting.
- [Database](https://docs.riff.ai/reference/app-builder/database.md): Browse your app's built-in database tables and inspect data — and ask the Riff agent to create, query, update, or delete records directly.
- [Packages](https://docs.riff.ai/reference/app-builder/packages.md): Packages shows all the libraries your app depends on and lets you add or remove them without using a command line.
- [Logs](https://docs.riff.ai/reference/app-builder/logs.md): The Logs panel shows real-time output from your app — backend print statements, API calls, errors, and browser console messages.
- [Deploy](https://docs.riff.ai/reference/app-builder/deploy.md): Deploy publishes your app to a permanent public URL so real users can access it.
- [App Settings](https://docs.riff.ai/reference/app-builder/app-settings.md): Per-app configuration — design guidelines, management settings, custom instructions, automations, and workspace controls.
- [Access](https://docs.riff.ai/reference/app-builder/access.md): The Access tab controls who can collaborate on your app, whether Riff support can view your workspace, and whether external systems can reach your development API.
- [Riff environment](https://docs.riff.ai/reference/app-builder/riff-environment.md): How Riff apps and agents are structured — the two environments (development and production), the file layout, and the infrastructure underneath.
- [Agent builder](https://docs.riff.ai/reference/agent-builder.md): The Agent builder is where you configure an autonomous agent — a worker that runs jobs, monitors processes, and takes action on your behalf.
- [Chat](https://docs.riff.ai/reference/agent-builder/chat.md): The Chat tab is the primary building surface in the Agent builder. Configure your agent by talking to the Riff agent here.
- [Pipeline](https://docs.riff.ai/reference/agent-builder/pipeline.md): The Pipeline tab shows your agent's tasks as a visual board — what the agent is working on, what's waiting, and what's done.
- [Profile](https://docs.riff.ai/reference/agent-builder/profile.md): The Profile tab shows your agent's full configuration — instructions, knowledge, skills, and tools — in one read-only view.
- [Triggers](https://docs.riff.ai/reference/agent-builder/triggers.md): The Triggers tab shows every way your agent can be activated — its email addresses and any scheduled runs you have set up.
- [Activity](https://docs.riff.ai/reference/agent-builder/activity.md): The Activity tab shows a log of every agent run — which tools were called, how long each step took, and whether it succeeded or failed.
- [The Riff agent](https://docs.riff.ai/reference/riff-agent.md): The Riff agent is the AI building assistant that works with you inside the App builder, the Agent builder, and Ask Riff. It is always the same agent — one consistent collaborator.
- [Chat panel](https://docs.riff.ai/reference/riff-agent/chat-panel.md): The controls, toggles, and input options in the Riff agent chat panel — the same in the App builder, Agent builder, and Ask Riff.
- [Build / Plan toggle](https://docs.riff.ai/reference/riff-agent/build-plan-toggle.md): The Build / Plan toggle switches the Riff agent between executing changes and planning them first without making any edits.
- [Skills](https://docs.riff.ai/reference/riff-agent/skills.md): Skills are reusable capability definitions you can load into the Riff agent during a conversation by typing / in the chat input.
- [Tools](https://docs.riff.ai/reference/riff-agent/tools.md): Tools are the actions the Riff agent can take on your behalf while helping you build — reading files, writing code, querying your database, and more.
- [Shared features](https://docs.riff.ai/reference/shared.md): Features available in both the App builder and Agent builder via the + tab picker.
- [Integrations](https://docs.riff.ai/reference/shared/integrations.md): Connect your app or agent to external services — ERPs, APIs, communication tools, and databases.
- [Storage](https://docs.riff.ai/reference/shared/storage.md): Upload and manage files your app or agent uses — internal files for backend processing and public assets served to users.
- [Secrets](https://docs.riff.ai/reference/shared/secrets.md): Secrets stores sensitive credentials — API keys, connection strings, tokens — in an encrypted vault your app or agent reads at runtime.
- [Access](https://docs.riff.ai/reference/shared/access.md): Control who can collaborate on your project, whether Riff support can view your workspace, and whether external systems can reach your development API.
- [Version History](https://docs.riff.ai/reference/shared/version-history.md)
- [Concepts](https://docs.riff.ai/concepts/concepts.md): Understand how Riff works — so you can deploy with confidence.
- [Apps and Agents](https://docs.riff.ai/concepts/apps-and-agents.md): When to build a screen, when to build a worker — and how Apps and Agents work together in Riff.
- [What is a Riff agent?](https://docs.riff.ai/concepts/what-is-a-riff-agent.md): What a Riff agent is, how to think about it, and what makes it different from automation or a chatbot.
- [How agents act on ERPs](https://docs.riff.ai/concepts/how-agents-act-on-erps.md): How Riff connects to your ERP and what "taking action" actually means at a technical level.
- [Reversibility and audit trail](https://docs.riff.ai/concepts/reversibility-and-audit-trail.md): How Riff ensures every agent action can be undone, every edge case reaches a human, and every step is logged.
- [Security](https://docs.riff.ai/concepts/security.md): Riff's security posture — SOC 2, SSO, GDPR, data residency, and access control.
- [Playbooks](https://docs.riff.ai/playbooks/playbooks.md): Step-by-step task guides for procurement, finance, and operations teams building on Riff.
- [Procurement](https://docs.riff.ai/playbooks/procurement.md): Riff playbooks for procurement teams — supplier confirmations, RFQs, PO matching, and delivery exceptions.
- [Chase supplier confirmations](https://docs.riff.ai/playbooks/procurement/chase-supplier-confirmations.md): Build a Riff agent that automatically chases unconfirmed purchase orders — so your buyers spend time on decisions, not status emails.
- [Run an RFQ](https://docs.riff.ai/playbooks/procurement/run-an-rfq.md): Build a Riff agent (or app) to send RFQs to suppliers, track responses, and surface the best quote — without the spreadsheet chase.
- [Match purchase orders to invoices](https://docs.riff.ai/playbooks/procurement/match-purchase-orders.md): Build a Riff agent that matches purchase orders to invoices, flags GR/IR discrepancies, and keeps your three-way match clean.
- [Handle delivery exceptions](https://docs.riff.ai/playbooks/procurement/handle-delivery-exceptions.md): Build a Riff workflow to surface inbound delivery discrepancies — short deliveries, wrong items, damaged goods — and keep your team moving.
- [Finance](https://docs.riff.ai/playbooks/finance.md): Riff playbooks for finance teams — invoice reconciliation, payment exceptions, and approval escalation.
- [Reconcile supplier invoices](https://docs.riff.ai/playbooks/finance/reconcile-supplier-invoices.md): Build a Riff agent that reconciles supplier invoices against purchase orders and goods receipts — so your AP team focuses on exceptions, not routine matching.
- [Escalate flagged transactions](https://docs.riff.ai/playbooks/finance/escalate-flagged-transactions.md): Build a Riff workflow to route payment exceptions and approval requests to the right person — automatically, with full audit trail.
- [Operations](https://docs.riff.ai/playbooks/operations.md): Riff playbooks for operations teams — open order monitoring, stock threshold alerts, and inbound logistics.
- [Monitor open orders](https://docs.riff.ai/playbooks/operations/monitor-open-orders.md): Build a Riff agent that watches your open purchase order pipeline and alerts on overdue or stalled orders — before they become supply disruptions.
- [Alert on stock thresholds](https://docs.riff.ai/playbooks/operations/alert-on-stock-thresholds.md): Build a Riff agent that monitors inventory levels and alerts your team — or triggers replenishment — when stock falls below threshold.
- [About Integrations](https://docs.riff.ai/integrations/about-integrations-v2.md): Connect Riff to your ERP and the tools your teams already use.
- [Native Integrations](https://docs.riff.ai/integrations/native-integrations-v2.md): Pre-built connectors for the ERPs and tools your procurement teams run on.
- [Infor LN / M3](https://docs.riff.ai/integrations/native-integrations-v2/infor-ln.md): Connect Riff to Infor LN or M3 to build procurement apps and agents on live ERP data.
- [SAP S/4HANA](https://docs.riff.ai/integrations/native-integrations-v2/sap.md): Connect Riff to SAP S/4HANA to build procurement apps and agents on live ERP data.
- [Oracle ERP Cloud](https://docs.riff.ai/integrations/native-integrations-v2/oracle-erp.md): Connect Riff to Oracle ERP Cloud to build procurement apps and agents on live purchasing, receiving, and payables data.
- [Microsoft Dynamics 365](https://docs.riff.ai/integrations/native-integrations-v2/dynamics-365.md): Connect Riff to Microsoft Dynamics 365 Finance & Operations to build procurement apps and agents on live ERP data.
- [Custom Integrations](https://docs.riff.ai/integrations/custom-integrations-v2.md): Connect Riff to freight carriers, EDI systems, supplier portals, compliance databases, and any external API your procurement team needs.
- [Configure a Custom Domain](https://docs.riff.ai/guides/configure-a-custom-domain-in-riff.md): This guide walks you through how to configure a custom domain for your app in Riff.
- [Archive (overview)](https://docs.riff.ai/archive/archive.md)
- [Getting Started (legacy)](https://docs.riff.ai/archive/getting-started-legacy.md)
- [Quickstart App](https://docs.riff.ai/archive/getting-started-legacy/quickstart.md): Turn raw customer comments into themes, sentiment, and an action plan — zero setup.
- [First prompt → first app](https://docs.riff.ai/archive/getting-started-legacy/first-prompt-first-app.md): Say what you need → Riff plans tiny steps → builds the pieces → you tweak and ship.
- [Meet the Riff Agent](https://docs.riff.ai/archive/getting-started-legacy/meet-the-riff-agent.md): Your doer‑in‑chief. You say it. It ships.
- [Quick Start Tutorials (legacy staging)](https://docs.riff.ai/archive/quick-start-tutorials-legacy-staging.md)
- [What you can build with Riff](https://docs.riff.ai/archive/quick-start-tutorials-legacy-staging/what-you-can-build-with-riff.md)
- [Quickstart: Agent](https://docs.riff.ai/archive/quick-start-tutorials-legacy-staging/quickstart-agent.md): Get a Monday‑morning email with 5 hand‑picked articles matched to your interests, job, and reading style - fully automated.
- [Quickstart: Dashboard](https://docs.riff.ai/archive/quick-start-tutorials-legacy-staging/quickstart-dashboard.md): Turn a Google Sheet into a live dashboard - no copy-paste, updates automatically.
- [Quick Start: Automation](https://docs.riff.ai/archive/quick-start-tutorials-legacy-staging/quick-start-automation.md): Collect feedback all day, get one AI summary in Slack every morning - zero manual checking.
- [Quick Start: Automation v2](https://docs.riff.ai/archive/quick-start-tutorials-legacy-staging/quick-start-automation-v2.md): Build an automation that pulls ERP exceptions every morning and posts a structured digest to Slack or Teams — unconfirmed deliveries, invoice mismatches, overdue POs.
- [Riff Automations](https://docs.riff.ai/archive/quick-start-tutorials-legacy-staging/riff-automations.md)
- [Templates](https://docs.riff.ai/archive/quick-start-tutorials-legacy-staging/templates.md)
- [What you can build with Riff (v2 staging)](https://docs.riff.ai/archive/quick-start-tutorials-legacy-staging/what-you-can-build-with-riff-v2.md): Apps and Agents — understand which build type fits your procurement or operations job before you start.
- [Use Cases (legacy SaaS framing)](https://docs.riff.ai/archive/use-cases-legacy-saas-framing.md)
- [Sales](https://docs.riff.ai/archive/use-cases-legacy-saas-framing/sales.md)
- [Marketing](https://docs.riff.ai/archive/use-cases-legacy-saas-framing/marketing.md)
- [Operations](https://docs.riff.ai/archive/use-cases-legacy-saas-framing/operations.md)
- [Finance](https://docs.riff.ai/archive/use-cases-legacy-saas-framing/finance.md)
- [Customer Experience](https://docs.riff.ai/archive/use-cases-legacy-saas-framing/customer-experience.md)
- [Integrations (legacy SaaS connectors)](https://docs.riff.ai/archive/integrations-legacy-saas-connectors.md)
- [About Integrations](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/about-integrations.md): Plug in. Power up. Build faster.
- [Native Integrations](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/native-integrations.md): Get going in minutes. OAuth in. Ship.
- [HubSpot](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/native-integrations/hubspot.md): How to build a Riff application with Hubspot integration.
- [Slack](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/native-integrations/slack.md)
- [Notion](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/native-integrations/notion.md)
- [Google Sheets](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/native-integrations/google-sheets.md)
- [Google Calendar](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/native-integrations/google-calendar.md)
- [Google Drive](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/native-integrations/google-drive.md)
- [Stripe](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/native-integrations/stripe.md)
- [Google BigQuery](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/native-integrations/google-bigquery.md)
- [Custom Integrations](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/custom-integrations.md): Any service. Your rules. No boilerplate — let the agent handle it.
- [Mixpanel](https://docs.riff.ai/archive/integrations-legacy-saas-connectors/custom-integrations/mixpanel.md)
- [Guides (legacy)](https://docs.riff.ai/archive/guides-legacy.md)
- [Where to see your credits](https://docs.riff.ai/archive/guides-legacy/where-to-see-your-credits.md): You can easily see your credits by pressing the name of your app. Gray area is the credits you have in your monthly subscription and white area is the credits used.
- [Migrating from Databutton](https://docs.riff.ai/archive/guides-legacy/migrating-from-databutton.md)
- [Features (legacy Databutton web-app-builder)](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder.md)
- [Agent Planning Mode](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/agent-planning-mode.md): Switch the agent between “research-first” and “build-now” workflows - with an explicit confirmation step.
- [Agent Tools](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/agent-tools.md): The agent drives; tools execute.
- [Native Authentication](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/native-authentication.md): Protect what matters with native email/password auth and one-click route protection. You focus on features; the platform handles sign-up, login, sessions, and resets.
- [Native Database](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/native-database.md): Build with confidence: every app gets a production-grade Postgres database out of the box. No setup, no glue code - just store, query, and ship.
- [Observability and Debugging](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/observability-and-debugging.md)
- [Riff Environment](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/riff-environment.md)
- [Deploy your Application](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/deploy-your-application.md): A guide to pre-deployment checks and deploying securely on the Riff platform
- [Version Control](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/version-control.md)
- [Security](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/security.md)
- [Workspace Features](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features.md): These features work together to give you a complete app development environment.
- [Preview](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features/preview.md): Preview, test and build your app
- [Tasks](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features/tasks.md): Build out a plan with tasks for building your app
- [Integrations](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features/integrations.md): Manage and install integrations with external services
- [Schedules](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features/schedules.md): Monitor, pause and start your scheduled tasks
- [Database & Users](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features/database-and-users.md): Explore the database for your workspace and your published app
- [Storage](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features/storage.md): View and manage your storage including dataframes and files
- [Secrets](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features/secrets.md): View and manage your credentials and environment variables
- [Access](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features/access.md): Manage access to your app, including advanced access control
- [Code Editor](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features/code-editor.md): View and edit your code, and restrict agent access
- [Packages](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/workspace-features/packages.md): View and install NPM and Python packages for your app
- [App Preference Features](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/app-preference-features.md)
- [Agent Preferences](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/app-preference-features/agent-preferences.md): Customize how your AI agent communicates and behaves when helping you build your application.
- [App Custom Instructions](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/app-preference-features/app-custom-instructions.md): Provide project-specific guidance that overrides your global agent preferences.
- [App Design](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/app-preference-features/app-design.md): Customize the visual appearance and design guidelines for your application.
- [App Management](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/app-preference-features/app-management.md): Provide context that helps the AI agent understand your application better.
- [Workspace Management](https://docs.riff.ai/archive/features-legacy-databutton-web-app-builder/app-preference-features/workspace-management.md)
- [Orphans](https://docs.riff.ai/archive/orphans.md)
- [Team Workspace / page-1](https://docs.riff.ai/archive/orphans/page-1.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on a page URL with the `ask` query parameter:
```
GET https://docs.riff.ai/welcome-to-riff-v2.md?ask=<question>
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.