Knowledge
Используйте векторный поиск
База знаний (Knowledge Base) — встроенная функция AACFlow, которая позволяет создавать, управлять и опрашивать собственные базы знаний прямо внутри платформы. Используя современные AI-эмбеддинги и векторный поиск, блок Knowledge Base даёт возможность встроить интеллектуальный поиск в ваши воркфлоу.
Интеграция Knowledge Base в AACFlow позволяет:
- Поиск по знаниям: выполняйте семантический поиск по вашим базам знаний с помощью AI-сравнения векторной близости
- Загрузка фрагментов: добавляйте текстовые фрагменты с метаданными в базу знаний для индексации
- Создание документов: добавляйте новые документы в базу знаний, чтобы их содержимое стало доступным для поиска
Блок Knowledge Base в AACFlow позволяет вашим агентам выполнять интеллектуальный семантический поиск по корпоративным знаниям в рамках автоматизированных воркфлоу. Это идеально подходит для извлечения информации, рекомендаций контента, автоматизации FAQ и подкрепления ответов агентов вашими собственными данными.
Интегрируйте Knowledge в рабочий процесс. Perform full CRUD operations on documents, chunks, и tags.
Поиск похожего контента in a knowledge base using vector similarity
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base to search in |
query | string | Нет | Search query text (optional when using tag filters) |
topK | number | Нет | Number of most similar results to return (1-100) |
tagFilters | array | Нет | Массив tag filters with tagName and tagValue properties |
items | object | Нет | No description |
properties | string | Нет | No description |
tagName | string | Нет | No description |
tagValue | string | Нет | No description |
tagFilters | string | Нет | No description |
| Параметр | Тип | Описание |
|---|
results | array | Массив 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 | AACFlowilarity 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 |
Загрузить новый фрагмент to a document in a knowledge base
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base containing the document |
documentId | string | Да | ID of the document to upload the chunk to |
content | string | Да | Content of the chunk to upload |
| Параметр | Тип | Описание |
|---|
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 | Произошла ли 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 |
Создать новый document in a knowledge base
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base containing the document |
name | string | Да | Name of the document |
content | string | Да | Content of the document |
documentTags | object | Нет | Document tags |
documentTags | string | Нет | No description |
| Параметр | Тип | Описание |
|---|
data | object | Information about the created document |
↳ documentId | string | Document ID |
↳ documentName | string | Document name |
↳ type | string | Document type |
↳ enabled | boolean | Произошла ли 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 |
Создать или update a document in a knowledge base. If a document с заданным ID или filename already exists, it will be replaced С помощью new content.
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base containing the document |
documentId | string | Нет | Optional ID of an existing document to update. Если не предоставлен, lookup is done by filename. |
name | string | Да | Name of the document |
content | string | Да | Content of the document |
documentTags | json | Нет | Document tags |
documentTags | string | Нет | No description |
| Параметр | Тип | Описание |
|---|
data | object | Information about the upserted document |
↳ documentId | string | Document ID |
↳ documentName | string | Document name |
↳ type | string | Document type |
↳ enabled | boolean | Произошла ли document is enabled |
↳ isUpdate | boolean | Whether an existing document was replaced |
↳ previousDocumentId | string | ID of the document that was replaced, if any |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last update timestamp |
message | string | Success or error message describing the operation result |
documentId | string | ID of the upserted document |
Список всех tag definitions для a knowledge base
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base to list tags for |
| Параметр | Тип | Описание |
|---|
knowledgeBaseId | string | ID of the knowledge base |
tags | array | Массив tag definitions for the knowledge base |
↳ id | string | Tag definition ID |
↳ tagSlot | string | Internal tag slot (e.g. tag1, number1) |
↳ displayName | string | Human-readable tag name |
↳ fieldType | string | Tag field type (text, number, date, boolean) |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last update timestamp |
totalTags | number | Total number of tag definitions |
Список documents in a knowledge base с optional фильтрация, search, и постраничная выборка
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base to list documents from |
search | string | Нет | Search query to filter documents by filename |
enabledFilter | string | Нет | Filter by enabled status: "all", "enabled", or "disabled" |
limit | number | Нет | Maximum number of documents to return (default: 50) |
offset | number | Нет | Number of documents to skip for постраничная выборка (default: 0) |
| Параметр | Тип | Описание |
|---|
knowledgeBaseId | string | ID of the knowledge base |
documents | array | Массив documents in the knowledge base |
↳ id | string | Document ID |
↳ filename | string | Document filename |
↳ fileSize | number | File size in bytes |
↳ mimeType | string | MIME type of the document |
↳ enabled | boolean | Произошла ли document is enabled |
↳ processingStatus | string | Processing status (pending, processing, completed, failed) |
↳ chunkCount | number | Number of chunks in the document |
↳ tokenCount | number | Total token count across chunks |
↳ uploadedAt | string | Upload timestamp |
↳ updatedAt | string | Last update timestamp |
↳ connectorId | string | Connector ID if document was synced from an external source |
↳ connectorType | string | Connector type (e.g. notion, github, confluence) if synced |
↳ sourceUrl | string | Original URL in the source system if synced from a connector |
totalDocuments | number | Total number of documents matching the filter |
limit | number | Page size used |
offset | number | Offset used for постраничная выборка |
Получить full details of a single document including tags, connector metadata, и processing status
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base the document belongs to |
documentId | string | Да | ID of the document to retrieve |
| Параметр | Тип | Описание |
|---|
id | string | Document ID |
filename | string | Document filename |
fileSize | number | File size in bytes |
mimeType | string | MIME type of the document |
enabled | boolean | Произошла ли document is enabled |
processingStatus | string | Processing status (pending, processing, completed, failed) |
processingError | string | Error message if processing failed |
chunkCount | number | Number of chunks in the document |
tokenCount | number | Total token count across chunks |
characterCount | number | Total character count |
uploadedAt | string | Upload timestamp |
updatedAt | string | Last update timestamp |
connectorId | string | Connector ID if document was synced from an external source |
sourceUrl | string | Original URL in the source system if synced from a connector |
externalId | string | External ID from the source system |
tags | object | Tag values keyed by tag slot (tag1-7, number1-5, date1-2, boolean1-3) |
Удалить document from a knowledge base
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base containing the document |
documentId | string | Да | ID of the document to delete |
| Параметр | Тип | Описание |
|---|
documentId | string | ID of the deleted document |
message | string | Confirmation message |
Список chunks для a document in a knowledge base с optional фильтрация и постраничная выборка
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base |
documentId | string | Да | ID of the document to list chunks from |
search | string | Нет | Search query to filter chunks by content |
enabled | string | Нет | Filter by enabled status: "true", "false", or "all" (default: "all") |
limit | number | Нет | Maximum number of chunks to return (1-100, default: 50) |
offset | number | Нет | Number of chunks to skip for постраничная выборка (default: 0) |
| Параметр | Тип | Описание |
|---|
knowledgeBaseId | string | ID of the knowledge base |
documentId | string | ID of the document |
chunks | array | Массив chunks in the document |
↳ id | string | Chunk ID |
↳ chunkIndex | number | Index of the chunk within the document |
↳ content | string | Chunk text content |
↳ contentLength | number | Content length in characters |
↳ tokenCount | number | Token count for the chunk |
↳ enabled | boolean | Произошла ли chunk is enabled |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last update timestamp |
totalChunks | number | Total number of chunks matching the filter |
limit | number | Page size used |
offset | number | Offset used for постраничная выборка |
Обновить the content или enabled status of a chunk in a knowledge base
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base |
documentId | string | Да | ID of the document containing the chunk |
chunkId | string | Да | ID of the chunk to update |
content | string | Нет | New content for the chunk |
enabled | boolean | Нет | Произошла ли chunk should be enabled or disabled |
| Параметр | Тип | Описание |
|---|
documentId | string | ID of the parent document |
id | string | Chunk ID |
chunkIndex | number | Index of the chunk within the document |
content | string | Updated chunk content |
contentLength | number | Content length in characters |
tokenCount | number | Token count for the chunk |
enabled | boolean | Произошла ли chunk is enabled |
updatedAt | string | Last update timestamp |
Удалить chunk from a document in a knowledge base
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base |
documentId | string | Да | ID of the document containing the chunk |
chunkId | string | Да | ID of the chunk to delete |
| Параметр | Тип | Описание |
|---|
chunkId | string | ID of the deleted chunk |
documentId | string | ID of the parent document |
message | string | Confirmation message |
Список всех connectors для a knowledge base, showing sync status, type, и document counts
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base to list connectors for |
| Параметр | Тип | Описание |
|---|
knowledgeBaseId | string | ID of the knowledge base |
connectors | array | Массив connectors for the knowledge base |
↳ id | string | Connector ID |
↳ connectorType | string | Type of connector (e.g. notion, github, confluence) |
↳ status | string | Connector status (active, paused, syncing) |
↳ syncIntervalMinutes | number | Sync interval in minutes (0 = manual only) |
↳ lastSyncAt | string | Timestamp of last sync |
↳ lastSyncError | string | Error from last sync if failed |
↳ lastSyncDocCount | number | Number of documents synced in last sync |
↳ nextSyncAt | string | Timestamp of next scheduled sync |
↳ consecutiveFailures | number | Number of consecutive sync failures |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last update timestamp |
totalConnectors | number | Total number of connectors |
Получить detailed connector information including recent sync logs для monitoring sync health
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base the connector belongs to |
connectorId | string | Да | ID of the connector to retrieve |
| Параметр | Тип | Описание |
|---|
connector | object | Connector details |
↳ id | string | Connector ID |
↳ connectorType | string | Type of connector |
↳ status | string | Connector status (active, paused, syncing) |
↳ syncIntervalMinutes | number | Sync interval in minutes |
↳ lastSyncAt | string | Timestamp of last sync |
↳ lastSyncError | string | Error from last sync if failed |
↳ lastSyncDocCount | number | Docs synced in last sync |
↳ nextSyncAt | string | Next scheduled sync timestamp |
↳ consecutiveFailures | number | Consecutive sync failures |
↳ createdAt | string | Creation timestamp |
↳ updatedAt | string | Last update timestamp |
syncLogs | array | Recent sync log entries |
↳ id | string | Sync log ID |
↳ status | string | Sync status |
↳ startedAt | string | Sync start time |
↳ completedAt | string | Sync completion time |
↳ docsAdded | number | Documents added |
↳ docsUpdated | number | Documents updated |
↳ docsDeleted | number | Documents deleted |
↳ docsUnchanged | number | Documents unchanged |
↳ errorMessage | string | Error message if sync failed |
Trigger a manual sync для a knowledge base connector
| Параметр | Тип | Обязательный | Описание |
|---|
knowledgeBaseId | string | Да | ID of the knowledge base the connector belongs to |
connectorId | string | Да | ID of the connector to trigger sync for |
| Параметр | Тип | Описание |
|---|
connectorId | string | ID of the connector that was synced |
message | string | Status message from the sync trigger |
