Vector Store Files

Add, list, and delete files in a vector store via LiteLLM

Vector store file capabilities index a file into a vector store, list its files, and delete files — calling the real LiteLLM API and surfacing backend errors.

Quick Start

1. Index a file with an Agent

   Use knowledge sources to let an agent index and search files automatically.

   from praisonaiagents import Agent
   
   agent = Agent(
       name="Docs Assistant",
       instructions="Answer questions from the indexed documents",
       knowledge=["report.pdf"]
   )
   
   agent.start("Summarise the key findings")

2. Direct capability call

   Add an already-uploaded file to a vector store.

   from praisonai.capabilities import vector_store_file_create
   
   result = vector_store_file_create(
       vector_store_id="vs_abc123",
       file_id="file_xyz789"
   )
   
   print(result.id, result.status)

How It Works

Configuration Options

vector_store_file_create

vector_store_file_list

vector_store_file_delete

Common Patterns

List then delete files:

from praisonai.capabilities import vector_store_file_list, vector_store_file_delete

files = vector_store_file_list("vs_abc123")
for f in files:
    print(f.id, f.status)

deleted = vector_store_file_delete("vs_abc123", "file_xyz789")
print(f"Deleted: {deleted}")  # False if the backend omits the flag

Async indexing:

import asyncio
from praisonai.capabilities import avector_store_file_create

async def main():
    result = await avector_store_file_create("vs_abc123", "file_xyz789")
    print(result.id)

asyncio.run(main())

Best Practices

Related