Skip to content
Garuda
Getting started

Adding knowledge your agent can answer from

Open the agent editor, go to Knowledge, and add a titled block of text. Each agent can hold five sources of up to 100,000 characters each, and every source is saved against the agent the moment you add it.

Last checked against the running product on 30 August 2026.

Knowledge is the material the agent answers from: your prices, your policies, your opening hours, the questions people keep asking. It is separate from the instructions, so you can correct a fact without rewriting how the agent behaves.

  1. Open the agent editor

    Go to Agents, open the agent, then choose Edit agent. In the builder, select the Knowledge section.

  2. Give the source a title

    The title box under Add a text knowledge source takes 1 to 200 characters. It is for you, not for visitors: something like Pricing and payment terms makes the list readable later.

  3. Paste the text

    The second box takes 1 to 100,000 characters. Paste plain text — the wording you would give a new member of staff. Long enough to be complete, short enough that every sentence is true.

    One subject per source

    Five sources is the whole allowance, so group by subject rather than by web page: pricing, delivery and returns, services, opening hours and contact, and a general company overview is a workable split.

  4. Choose Add and save source

    The source is written to the agent immediately — there is no separate save for it. If the agent has not been created yet, Garuda creates it first and then attaches the source.

  5. Check the status badge

    Each saved source appears as a row with its title, its character count and a status:

    What a knowledge source status means
    StatusMeaning
    ReadyThe text is stored and available to the agent.
    ProcessingThe deployment has retrieval indexing switched on and the source is still being prepared.
    FailedPreparation did not complete. Remove the source and add it again.
  6. Test the answer

    Use Test in the builder, or the Conversation playground on the agent page, and ask the question a customer would ask. If the answer is wrong, the fix is almost always in the text you pasted rather than in the instructions.

Two things this screen does not do yet

There is no website crawler: the URL box under Website ingestion is disabled, and says so. And the builder has no button to delete a source once it is saved — the API supports removal, but no control in the portal calls it yet, so contact info@ravan.ai if you need a source taken off an agent.

If it still does not work

Add and save source is greyed out

Both the title and the text must contain something. The button also stays disabled while another action in the builder is still running.

The save is rejected with a source limit message

An agent holds a maximum of five sources. Consolidate two of your existing sources into one and re-add, or use a second agent for a different part of the site.

The text is refused as too long

The limit is 100,000 characters for a single source. Split the material by subject rather than pasting a whole site export into one box.

The agent still answers as though the source is not there

Check the status badge is Ready, and check the wording actually contains the fact you expect. Instructions that tell the agent to answer only from approved knowledge will make it decline rather than guess — which is the intended behaviour, and the signal that the fact is missing.

Back to all help articles

Still stuck?

Every article here is written from the product as it works today. If something on this page does not match what you see in your workspace, trust the product and tell us — include the page you were on and what you expected.