Knowledge Files

Give your agent contextual knowledge about your business, products, and FAQs. The agent automatically uses this knowledge during conversations to answer questions accurately.

What is the Knowledge Base?

The knowledge base feeds your agent with grounded facts — reducing hallucinations and keeping responses accurate. Vozzo supports two knowledge input types:

Upload a File

Use the multipart/form-data content type to upload files. You can also specify optional tags.

cURL
 
curl -X POST https://backend.vozzo.ai/agent/upload-agent-knowledge-base/{agent_uuid}/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -F "knowledge_file=@product-guide.pdf" \
  -F "tags=company,overview"

JavaScript
 
const formData = new FormData();
formData.append("knowledge_file", fileBlob, "product-guide.pdf");
formData.append("tags", "company,overview");

await fetch(
  `https://backend.vozzo.ai/agent/upload-agent-knowledge-base/${agentUuid}/`,
  {
    method: "POST",
    headers: { Authorization: "Token YOUR_API_KEY" },
    body: formData,
  },
);

Add Website URLs

Vozzo scrapes and indexes public URLs. URLs are validated before indexing.

cURL
 
curl -X POST https://backend.vozzo.ai/agent/update-agent-widsom/{agent_uuid}/ \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "website_urls": "https://yourcompany.com/faq"
  }'

Validate URL

Validate a URL using Vozzo's scraping engine to ensure it is crawlable and contains useful content.

cURL
 
curl -X GET "https://backend.vozzo.ai/agent/url-validate?url=https://yourcompany.com/faq" \
  -H "Authorization: Token YOUR_API_KEY"

Retrieve Knowledge Base

Get the current state of your agent's knowledge base, including uploaded files and tracked URLs.

cURL
 
curl -X POST https://backend.vozzo.ai/agent/get-agent-widsom/{agent_uuid}/ \
  -H "Authorization: Token YOUR_API_KEY"

Delete Knowledge File

To delete a file, you must provide the file_key associated with it.

cURL
 
curl -X POST "https://backend.vozzo.ai/agent/delete-agent-knowledge-base/{agent_uuid}/?file_key=product-guide.pdf" \
  -H "Authorization: Token YOUR_API_KEY"

Best Practices