Knowledge Base: Upload and Manage Documents with the SDK

Go to app.futureagi.com → Knowledge base (left sidebar) → Create Knowledge Base.

1. Enter a name: product-docs
2. In the Upload tab, upload your documents (PDF, TXT, DOCX, or RTF)
3. Click Create

product-docs appears in the Knowledge base list with your files processing.

Click on product-docs in the Knowledge Base list. Inside, you can see:

• All uploaded files with their file size and processing status
• Add docs: upload additional documents
• Create Synthetic data: generate a synthetic dataset grounded in this KB (available once processing completes)

Create and manage a KB programmatically instead of through the dashboard:

import os
from fi.kb import KnowledgeBase

kb_client = KnowledgeBase(
    fi_api_key=os.environ["FI_API_KEY"],
    fi_secret_key=os.environ["FI_SECRET_KEY"],
)

kb_client.create_kb(
    name="product-docs",
    file_paths=[
        "./docs/return-policy.txt",
        "./docs/shipping-info.txt",
        "./docs/product-catalog.pdf",
    ],
)

print(f"KB created: {kb_client.kb.name}")

You should see:

KB created: product-docs

An unsupported file type fails the call instead of silently skipping it:

kb_client.create_kb(
    name="product-docs",
    file_paths=["./docs/changelog.md"],
)

You should see:

UnsupportedFileType: File type '.md' is not supported. Supported types: pdf, docx, txt, rtf

Convert the file and retry:

kb_client.create_kb(
    name="product-docs",
    file_paths=["./docs/changelog.txt"],
)

print(f"KB created: {kb_client.kb.name}")

You should see:

KB created: product-docs

When your content changes, add files without recreating the KB:

kb_client.update_kb(
    kb_name="product-docs",
    file_paths=["./docs/warranty-policy.txt"],
)

print("New document added to product-docs.")

You should see:

New document added to product-docs.

Rename the KB in the same call:

kb_client.update_kb(
    kb_name="product-docs",
    new_name="product-docs-v2",
    file_paths=["./docs/new-policy.txt"],
)

You should see: the KB now listed as product-docs-v2.

Remove specific files from a KB:

kb_client.delete_files_from_kb(
    file_names=["return-policy.txt"],
    kb_name="product-docs",
)

print("File removed from KB.")

You should see:

File removed from KB.

Delete the entire KB:

kb_client.delete_kb(kb_names="product-docs")

print("KB deleted.")

You should see:

KB deleted.

Attach the Knowledge Base to a dataset evaluation so the evaluator grounds its scoring in your domain documents.

1. Go to app.futureagi.com → Dataset → open your dataset
2. Click Evaluate → Add Evaluations → select an eval metric (e.g. completeness)
3. In the evaluation configuration, find the Knowledge base dropdown
4. Select your KB (e.g. product-docs)
5. Map the remaining keys and click Add & Run

The eval column fills in with scores and reasons grounded in your KB documents.