Knowledge Base SDK

from fi.kb import KnowledgeBase

kb_client = KnowledgeBase()

KnowledgeBase() reads FI_API_KEY and FI_SECRET_KEY from the environment, so no arguments are required. Pass kb_name here instead if you want the client to attach to a knowledge base that already exists.

kb_client = kb_client.create_kb(
    name="support-policies",
    file_paths=["docs/refund-policy.txt", "docs/shipping-policy.txt"],
)

print("Created support-policies")

create_kb returns the client itself, so kb_client stays the same object. If the call returns without raising, the knowledge base was created with both files.

update_kb requires kb_name: it looks the knowledge base up by name before it applies the change, so it has no default to fall back on. Leaving it out fails:

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

TypeError: update_kb() missing 1 required positional argument: 'kb_name'

Pass it explicitly:

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

print("Added warranty-policy.txt")

If the call returns without raising, the file was added.

for file in kb_client.kb.files:
    print(file)

This loop prints the file IDs the knowledge base holds. kb_client.kb is refreshed after every create or update call; the delete calls in the next two steps don’t update this cache.

kb_client = kb_client.delete_files_from_kb(
    file_names=["shipping-policy.txt"],
)

delete_files_from_kb doesn’t raise if the deletion succeeds. file_names takes the file’s base name as stored in the knowledge base, not its local path: docs/shipping-policy.txt from step 2 is removed here by shipping-policy.txt.

kb_client.delete_kb(kb_names=["support-policies"])

from fi.kb import KnowledgeBase

KnowledgeBase(kb_name="support-policies")

You should see:

SDKException: Knowledge Base with name 'support-policies' not found. Please create it first or verify the name.

That confirms the knowledge base is gone: nothing by that name can be resolved anymore.