mirror of
https://github.com/simstudioai/sim.git
synced 2026-04-06 03:00:16 -04:00
126 lines
5.0 KiB
Plaintext
126 lines
5.0 KiB
Plaintext
---
|
|
title: Knowledge
|
|
description: Use vector search
|
|
---
|
|
|
|
import { BlockInfoCard } from "@/components/ui/block-info-card"
|
|
|
|
<BlockInfoCard
|
|
type="knowledge"
|
|
color="#00B0B0"
|
|
/>
|
|
|
|
{/* MANUAL-CONTENT-START:intro */}
|
|
Sim's Knowledge Base is a native feature that enables you to create, manage, and query custom knowledge bases directly within the platform. Using advanced AI embeddings and vector search, the Knowledge Base block allows you to build intelligent search capabilities into your workflows.
|
|
|
|
With the Knowledge Base in Sim, you can:
|
|
|
|
- **Search knowledge**: Perform semantic searches across your custom knowledge bases using AI-powered vector similarity matching
|
|
- **Upload chunks**: Add text chunks with metadata to a knowledge base for indexing
|
|
- **Create documents**: Add new documents to a knowledge base for searchable content
|
|
|
|
In Sim, the Knowledge Base block enables your agents to perform intelligent semantic searches across your organizational knowledge as part of automated workflows. This is ideal for information retrieval, content recommendations, FAQ automation, and grounding agent responses in your own data.
|
|
{/* MANUAL-CONTENT-END */}
|
|
|
|
|
|
## Usage Instructions
|
|
|
|
Integrate Knowledge into the workflow. Can search, upload chunks, and create documents.
|
|
|
|
|
|
|
|
## Tools
|
|
|
|
### `knowledge_search`
|
|
|
|
Search for similar content in a knowledge base using vector similarity
|
|
|
|
#### Input
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `knowledgeBaseId` | string | Yes | ID of the knowledge base to search in |
|
|
| `query` | string | No | Search query text \(optional when using tag filters\) |
|
|
| `topK` | number | No | Number of most similar results to return \(1-100\) |
|
|
| `tagFilters` | array | No | Array of tag filters with tagName and tagValue properties |
|
|
| `items` | object | No | No description |
|
|
| `properties` | string | No | No description |
|
|
| `tagName` | string | No | No description |
|
|
| `tagValue` | string | No | No description |
|
|
| `tagFilters` | string | No | No description |
|
|
|
|
#### Output
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `results` | array | Array of search results from the knowledge base |
|
|
| ↳ `documentId` | string | Document ID |
|
|
| ↳ `documentName` | string | Document name |
|
|
| ↳ `content` | string | Content of the result |
|
|
| ↳ `chunkIndex` | number | Index of the chunk within the document |
|
|
| ↳ `similarity` | number | Similarity score of the result |
|
|
| ↳ `metadata` | object | Metadata of the result, including tags |
|
|
| `query` | string | The search query that was executed |
|
|
| `totalResults` | number | Total number of results found |
|
|
| `cost` | object | Cost information for the search operation |
|
|
|
|
### `knowledge_upload_chunk`
|
|
|
|
Upload a new chunk to a document in a knowledge base
|
|
|
|
#### Input
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `knowledgeBaseId` | string | Yes | ID of the knowledge base containing the document |
|
|
| `documentId` | string | Yes | ID of the document to upload the chunk to |
|
|
| `content` | string | Yes | Content of the chunk to upload |
|
|
|
|
#### Output
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `data` | object | Information about the uploaded chunk |
|
|
| ↳ `chunkId` | string | Chunk ID |
|
|
| ↳ `chunkIndex` | number | Index of the chunk within the document |
|
|
| ↳ `content` | string | Content of the chunk |
|
|
| ↳ `contentLength` | number | Length of the content in characters |
|
|
| ↳ `tokenCount` | number | Number of tokens in the chunk |
|
|
| ↳ `enabled` | boolean | Whether the chunk is enabled |
|
|
| ↳ `createdAt` | string | Creation timestamp |
|
|
| ↳ `updatedAt` | string | Last update timestamp |
|
|
| `message` | string | Success or error message describing the operation result |
|
|
| `documentId` | string | ID of the document the chunk was added to |
|
|
| `documentName` | string | Name of the document the chunk was added to |
|
|
| `cost` | object | Cost information for the upload operation |
|
|
|
|
### `knowledge_create_document`
|
|
|
|
Create a new document in a knowledge base
|
|
|
|
#### Input
|
|
|
|
| Parameter | Type | Required | Description |
|
|
| --------- | ---- | -------- | ----------- |
|
|
| `knowledgeBaseId` | string | Yes | ID of the knowledge base containing the document |
|
|
| `name` | string | Yes | Name of the document |
|
|
| `content` | string | Yes | Content of the document |
|
|
| `documentTags` | object | No | Document tags |
|
|
| `documentTags` | string | No | No description |
|
|
|
|
#### Output
|
|
|
|
| Parameter | Type | Description |
|
|
| --------- | ---- | ----------- |
|
|
| `data` | object | Information about the created document |
|
|
| ↳ `documentId` | string | Document ID |
|
|
| ↳ `documentName` | string | Document name |
|
|
| ↳ `type` | string | Document type |
|
|
| ↳ `enabled` | boolean | Whether the document is enabled |
|
|
| ↳ `createdAt` | string | Creation timestamp |
|
|
| ↳ `updatedAt` | string | Last update timestamp |
|
|
| `message` | string | Success or error message describing the operation result |
|
|
| `documentId` | string | ID of the created document |
|
|
|
|
|