Set up the portal agent's tone and knowledge

Updated

Who can do this: Super Admins

The portal agent answers customer questions in the customer portal, where customers see it labeled OnRamp AI. On its settings page, you choose its tone and give it knowledge about your company and onboarding. You save your changes as a draft, then publish them when they're ready.

Before you begin

  • The portal agent settings are available when they're turned on for your organization. If you don't see them, contact your OnRamp team.

  • If your seat license can view these settings but not edit them, you'll see the page read-only. Save draft, Publish, the text fields and Draft with Aero are turned off.

Open the portal agent settings

  1. Go to Settings > Aero.

  2. If the page shows more than one tab, select Portal agent.

Until you add any knowledge, the page shows No knowledge added yet. Until then, the agent answers only from live project data and tells customers when it doesn't know something.

Choose the agent's tone

Under Agent tone, choose the default style for every answer:

Tone

Style

Friendly (default)

Warm and approachable. Encourages the customer.

Concise

Short, direct. Minimal explanation.

Supportive

Empathetic and patient. Good for complex onboarding.

Technical

Precise and detailed. Good for technical audiences.

Add company and onboarding knowledge

Under Agent knowledge, there are two text fields. Each one holds up to 300 words:

  • Company & product knowledge: who you are, what you sell, support contacts and key policies.

  • Onboarding context: how your implementation process works, with timelines, escalation paths and what customers should expect at each step.

Enter your text in either field. If your organization writes its own help center in OnRamp and portal agent knowledge is on, the agent also answers from help center articles your customers can read. It checks them after project data and these settings, and before knowledge files. The page has no setting for this.

Optional: Draft a section with Aero

Draft with Aero appears only when portal agent knowledge isn't turned on for your organization. Aero drafts from your guidance, the section's text, reference files you approve and your organization's details.

  1. In Company & product knowledge or Onboarding context, select Draft with Aero.

  2. Optional: In Guidance for Aero, enter what to include or emphasize.

  3. Optional: Expand Reference documents. Select Upload a file to add a .md or .txt file, or choose a file from Add a file… and select Add.

  4. Select the Approve icon next to each file you want Aero to use. Aero uses files only after you approve them, and approvals save right away.

  5. Select Generate draft.

  6. Review the Suggested draft, then select Apply to section. If the section already has text, select Replace.

The applied draft stays an unsaved edit you can discard until you save. A reference document can be up to 2 MB. A file over 3 MB is refused with That file is larger than 3 MB. Files uploaded here are kept as private reference files and aren't added to Resources.

When portal agent knowledge is turned on and you can view Resources, a Portal agent knowledge card appears under Agent knowledge. It lists the files the agent can search. Adding a file here doesn't show it to customers.

  • To upload a file, select Upload and choose a .md, .txt, .pdf, .docx, .csv, .xlsx or .pptx file. It's saved to the Portal agent folder in Resources as soon as it uploads.

  • To use files already in Resources, select Manage in Resources and mark them there. Marking files needs permission to edit resources, and Super Admins can also add whole folders.

Uploads follow your Resources file size limit, which is 100 MB by default. If a file can't go straight to Resources storage, the limit is 3 MB, and a larger file is refused with That file is larger than 3 MB.

When website knowledge is turned on for your organization, Agent knowledge also shows a Website knowledge card. Use it to point the agent at a public help center or sitemap.

Test your changes

Each section has a Try it panel. Enter a sample question and select Test to preview an answer with the current tone and knowledge. Testing doesn't affect live conversations.

Save and publish

While you have unsaved edits, each edited section is marked Unsaved. A bar shows You have unsaved changes, with Discard and Save draft.

  1. Select Save draft. Your draft doesn't affect live conversations.

  2. Select Publish.

  3. In Publish these changes?, select Publish.

Published changes go live on the agent's next message. The header shows who saved the draft and when, who published and when, and the published version number, such as v3. It also shows one of these statuses:

Status

Meaning

Not published yet

No settings have been published.

Unpublished draft

A saved draft hasn't been published.

Draft matches live

Your draft and the published settings are the same.

Unsaved edits

You have changes that aren't saved to the draft.

If you leave the page with unsaved edits, you can select Save draft, Leave without saving or Cancel.

More in OnRamp Aero