# Build an agent that answers from your documents

Build a leave policy assistant that answers staff questions from the HR policies, says so when the policies are silent, and changes nothing.

An answering agent replies to a person's question from documents you have approved, and changes nothing in any system. This tutorial builds one: a leave policy assistant for staff. It is the first of the ten forms in [Which builder for which agent](/agents/choose-a-builder), and the simplest to run.

**Who can use it:** the **Builder** role or higher, in a tenant licensed for agents and knowledge.

## Prerequisites

- A knowledge source that holds the HR policies: a set of documents the platform has indexed so an agent can search it. A Builder creates one under **Knowledge Sources** in Studio; see [Add a knowledge source](/knowledge/knowledge-bases/add-a-knowledge-source). Wait until its documents have finished indexing.
- A team you belong to. Every agent needs an **Owner team** before it can be published. If you are in none, ask an administrator; see [Before you build a form of agent](/agents/forms/before-you-build).

## Build the assistant

  
**Step 1. Start a blank draft**

In Studio, open **My Agents** and select **New agent**. Select **Answer & assist**, then **Search your docs**. Pick the **Blank** card and select **Continue to build**. The builder opens on **Identity**, with the draft named **Untitled agent · Draft** in the header.

  
**Step 2. Name it and pick the owner**

Type the **Display name** `Leave Policy Assistant`. The slug, the short name used in the agent's address, comes from it. Add one sentence of **Description**, because that is what people see wherever they pick an agent. Under **Ownership & routing**, pick the **Owner team**.

  
**Step 3. Write the instructions**

Open **Behavior**. The system prompt is the standing instruction the agent follows on every turn. Paste the instructions from the next section. Then choose the **Model tier**. Keep **Balanced**; the AI Gateway resolves the model at run time.
    ![The agent builder on Behavior for a draft named Leave Policy Assistant: the System prompt card with the instructions in the text box and a token count above it, the Model tier card below, and the Agent draft rail on the right giving the type as Search your docs.](https://docs.katonic.ai/img/agents/forms/answer-from-your-documents/forms-answer-behavior.png)
*Behavior holds the instructions. Say what the agent answers from, how it cites, and what it says when the documents are silent.*

  
**Step 4. Attach the policies**

Open **Knowledge**. Switch on the source that holds the HR policies. Filter by connector or sort the list to find it, and use **Attached only** to check what the agent will read. Under **When the knowledge base cannot answer**, keep the first choice, which has the agent say that the answer is not in its knowledge. You should now see one source counted as attached at the top of the section and in the **Agent draft** rail.
    ![The Knowledge section with one source attached: the attached count, the three choices under When the knowledge base cannot answer with the first selected, the Attached only filter on, one source row with its switch on, and the Agent draft rail counting one knowledge base.](https://docs.katonic.ai/img/agents/forms/answer-from-your-documents/forms-answer-knowledge.png)
*Knowledge attaches the sources the agent reads. The choice above the list decides what it does when a search finds nothing usable.*

  
**Step 5. Pick a guardrail profile**

Open **Guardrails** and pick a profile. A profile is a named set of safety checks, called rails, that an administrator created in the Control Room. They run on every turn of this agent.

## The assistant's instructions

Paste this, and change the third paragraph to name your own HR team.

```text
You answer staff questions about leave: annual leave, sick leave, parental leave and public holidays.

Answer only from the HR policies you are given. After each answer, name the policy and the paragraph you relied on.

If the policies do not answer the question, say that they do not, and tell the person to ask the HR team. Do not answer from general knowledge.

You do not approve leave, change a balance or book anything. Keep answers under 150 words.
```

## Test and publish

  
**Step 1. Save two test prompts**

Open **Test**. Add a prompt with the plus button for a question your policies answer, and a second for one they do not. The two used here:

    ```text
    How many days of annual leave does a new starter get in their first year?
    Can I carry my leave over if I move to our office in another country?
    ```
    ![The Test tab for the Leave Policy Assistant draft: two saved test prompts on the left, one for a question the policy covers and one for a question it does not, the sandbox message box with Run in the middle, and the empty Run trace on the right.](https://docs.katonic.ai/img/agents/forms/answer-from-your-documents/forms-answer-test.png)
*Test runs the draft without publishing it. Save one prompt the documents answer and one they do not.*

  
**Step 2. Run them**

Pick a prompt and select **Run**. The answer streams in, and the **Run trace** on the right shows the steps of the real run with its duration and tokens.

  
**Step 3. Publish**

Select **Publish**. Fix any blocker the dialog names, choose who can use the agent under **Who can use it**, and tick **Work Room** under **Where it runs**. The screen that follows says where the version landed: live, in a lane to promote, or not live yet. [Before you build a form of agent](/agents/forms/before-you-build) says what each means and how to roll back.

## Verify

Run the first prompt. The answer states the entitlement your policy gives and ends by naming the policy and the paragraph. Run the second. The answer says the policies do not cover the question and points to the HR team, and gives no entitlement.

Then check what members see. In the Work Room, open the agent and ask the first question again. The same answer comes back.

## Troubleshooting

- **The answer to the covered question is wrong or vague.** Open the knowledge source and use [Search and test](/knowledge/knowledge-bases/search-and-test) with the same question. If the right passage does not come back, the fault is in the source, not the agent.
- **The agent answers the uncovered question anyway.** Check the choice under **When the knowledge base cannot answer**, and that the third paragraph of the instructions is still there.
- **The source is not in the list.** It has not been created yet, or you cannot see it. Create it under **Knowledge Sources**, or ask its owner for access; see [Access](/knowledge/knowledge-bases/access).
- **The source is listed but the answers are empty.** Its documents may still be indexing. Open the source and check its documents.
- Blockers, an empty team list and other failures every form shares are in [Before you build a form of agent](/agents/forms/before-you-build).

## Related

- [Which builder for which agent](/agents/choose-a-builder)
- [Build an answer agent](/agents/build-an-answer-agent)
- [Test, publish and versions](/agents/test-publish-and-versions)
- Next form: [Build an agent that acts on a request](/agents/forms/act-on-a-request)

Source: https://docs.katonic.ai/agents/forms/answer-from-your-documents
