agent-knowledge

Add Knowledge Urls

Add knowledge base URLs to an existing agent.

PHASE 3 MIGRATION: Now scrapes websites locally and adds to knowledge base.

This endpoint:

Fetches content from the provided URLs
Extracts text from HTML
Chunks and embeds the content locally
Stores in local FAISS vector index
Makes web content immediately searchable for RAG

Example:

{
  "urls": [
    "https://company.com/about",
    "https://docs.company.com/api-guide"
  ]
}

Supports:

HTTP/HTTPS URLs
HTML content extraction
Concurrent fetching (up to 3 URLs at once)
Automatic chunking and embedding

POST

agents

{agent_id}

knowledge

urls

Add Knowledge Urls

curl --request POST \
  --url https://api.example.com/agents/{agent_id}/knowledge/urls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "urls": [
    "<string>"
  ]
}
'

{
  "agent_id": "<string>",
  "urls_added": 123,
  "task_id": "<string>",
  "message": "<string>"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id

string<uuid>

required

Body

application/json

Request to add knowledge base URLs to an agent.

urls

string[]

required

List of URLs to add to knowledge base

Minimum array length: 1

Response

Successful Response

Response from adding knowledge URLs.

agent_id

string

required

urls_added

integer

required

task_id

string

required

message

string

required

Upload DocumentsUpload PDF/document files to an agent's knowledge base. **PHASE 3 MIGRATION**: Now uses local vector store (FAISS) instead of external factory. This endpoint: - Accepts multiple PDF/document files - Processes them locally (extract text, chunk, embed) - Stores embeddings in local FAISS vector index - Makes documents immediately searchable for RAG Supported formats: PDF, TXT, DOCX, MD Max file size: 10MB per file

Add Knowledge Urls

curl --request POST \
  --url https://api.example.com/agents/{agent_id}/knowledge/urls \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "urls": [
    "<string>"
  ]
}
'

{
  "agent_id": "<string>",
  "urls_added": 123,
  "task_id": "<string>",
  "message": "<string>"
}

Documentation Index

Authorizations

Path Parameters

Body

Response