Algolia

使用说明

Integrate Algolia into your workflow. Search indices, manage records (add, update, delete, browse), configure index settings, and perform batch operations.

工具

`algolia_search`

Search an Algolia index

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia API Key
`indexName`	string	是	Name of the Algolia index to search
`query`	string	是	Search query text
`hitsPerPage`	number	否	Number of hits per page (default: 20)
`page`	number	否	Page number to retrieve (default: 0)
`filters`	string	否	Filter string (e.g., "category:electronics AND price < 100")
`attributesToRetrieve`	string	否	Comma-separated list of attributes to retrieve

输出

参数	类型	描述
`hits`	array	Array of matching records
↳ `objectID`	string	Unique identifier of the record
↳ `_highlightResult`	object	Highlighted attributes matching the query. Each attribute has value, matchLevel (none, partial, full), and matchedWords
↳ `_snippetResult`	object	Snippeted attributes matching the query. Each attribute has value and matchLevel
↳ `_rankingInfo`	object	Ranking information for the hit. Only present when getRankingInfo is enabled
↳ `nbTypos`	number	Number of typos in the query match
↳ `firstMatchedWord`	number	Position of the first matched word
↳ `geoDistance`	number	Distance in meters for geo-search results
↳ `nbExactWords`	number	Number of exactly matched words
↳ `userScore`	number	Custom ranking score
↳ `words`	number	Number of matched words
`nbHits`	number	Total number of matching hits
`page`	number	Current page number (zero-based)
`nbPages`	number	Total number of pages available
`hitsPerPage`	number	Number of hits per page (1-1000, default 20)
`processingTimeMS`	number	Server-side processing time in milliseconds
`query`	string	The search query that was executed
`parsedQuery`	string	The query string after normalization and stop word removal
`facets`	object	Facet counts keyed by facet name, each containing value-count pairs
`facets_stats`	object	Statistics (min, max, avg, sum) for numeric facets
`exhaustive`	object	Exhaustiveness flags for facetsCount, facetValues, nbHits, rulesMatch, and typo

`algolia_add_record`

Add or replace a record in an Algolia index

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia Admin API Key
`indexName`	string	是	Name of the Algolia index
`objectID`	string	否	Object ID for the record (auto-generated if not provided)
`record`	json	是	JSON object representing the record to add

输出

参数	类型	描述
`taskID`	number	Algolia task ID for tracking the indexing operation
`objectID`	string	The object ID of the added or replaced record
`createdAt`	string	Timestamp when the record was created (only present when objectID is auto-generated)
`updatedAt`	string	Timestamp when the record was updated (only present when replacing an existing record)

`algolia_get_record`

Get a record by objectID from an Algolia index

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia API Key
`indexName`	string	是	Name of the Algolia index
`objectID`	string	是	The objectID of the record to retrieve
`attributesToRetrieve`	string	否	Comma-separated list of attributes to retrieve

输出

参数	类型	描述
`objectID`	string	The objectID of the retrieved record
`record`	object	The record data (all attributes)

`algolia_get_records`

Retrieve multiple records by objectID from one or more Algolia indices

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia API Key
`indexName`	string	是	Default index name for all requests
`requests`	json	是	Array of objects specifying records to retrieve. Each must have "objectID" and optionally "indexName" and "attributesToRetrieve".

输出

参数	类型	描述
`results`	array	Array of retrieved records (null entries for records not found)
↳ `objectID`	string	Unique identifier of the record

`algolia_partial_update_record`

Partially update a record in an Algolia index without replacing it entirely

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia Admin API Key
`indexName`	string	是	Name of the Algolia index
`objectID`	string	是	The objectID of the record to update
`attributes`	json	是	JSON object with attributes to update. Supports built-in operations like {"stock": {"_operation": "Decrement", "value": 1}}
`createIfNotExists`	boolean	否	Whether to create the record if it does not exist (default: true)

输出

参数	类型	描述
`taskID`	number	Algolia task ID for tracking the update operation
`objectID`	string	The objectID of the updated record
`updatedAt`	string	Timestamp when the record was updated

`algolia_delete_record`

Delete a record by objectID from an Algolia index

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia Admin API Key
`indexName`	string	是	Name of the Algolia index
`objectID`	string	是	The objectID of the record to delete

输出

参数	类型	描述
`taskID`	number	Algolia task ID for tracking the deletion
`deletedAt`	string	Timestamp when the record was deleted

`algolia_browse_records`

Browse and iterate over all records in an Algolia index using cursor pagination

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia API Key (must have browse ACL)
`indexName`	string	是	Name of the Algolia index to browse
`query`	string	否	Search query to filter browsed records
`filters`	string	否	Filter string to narrow down results
`attributesToRetrieve`	string	否	Comma-separated list of attributes to retrieve
`hitsPerPage`	number	否	Number of hits per page (default: 1000, max: 1000)
`cursor`	string	否	Cursor from a previous browse response for pagination

输出

参数	类型	描述
`hits`	array	Array of records from the index (up to 1000 per request)
↳ `objectID`	string	Unique identifier of the record
`cursor`	string	Opaque cursor string for retrieving the next page of results. Absent when no more results exist.
`nbHits`	number	Total number of records matching the browse criteria
`page`	number	Current page number (zero-based)
`nbPages`	number	Total number of pages available
`hitsPerPage`	number	Number of hits per page (1-1000, default 1000 for browse)
`processingTimeMS`	number	Server-side processing time in milliseconds

`algolia_batch_operations`

Perform batch add, update, partial update, or delete operations on records in an Algolia index

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia Admin API Key
`indexName`	string	是	Name of the Algolia index
`requests`	json	是	Array of batch operations. Each item has "action" (addObject, updateObject, partialUpdateObject, partialUpdateObjectNoCreate, deleteObject) and "body" (the record data, must include objectID for update/delete)

输出

参数	类型	描述
`taskID`	number	Algolia task ID for tracking the batch operation
`objectIDs`	array	Array of object IDs affected by the batch operation

`algolia_list_indices`

List all indices in an Algolia application

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia API Key
`page`	number	否	Page number for paginating indices (default: not paginated)
`hitsPerPage`	number	否	Number of indices per page (default: 100)

输出

参数	类型	描述
`indices`	array	List of indices in the application
↳ `name`	string	Name of the index
↳ `entries`	number	Number of records in the index
↳ `dataSize`	number	Size of the index data in bytes
↳ `fileSize`	number	Size of the index files in bytes
↳ `lastBuildTimeS`	number	Last build duration in seconds
↳ `numberOfPendingTasks`	number	Number of pending indexing tasks
↳ `pendingTask`	boolean	Whether the index has pending tasks
↳ `createdAt`	string	Timestamp when the index was created
↳ `updatedAt`	string	Timestamp when the index was last updated
↳ `primary`	string	Name of the primary index (if this is a replica)
↳ `replicas`	array	List of replica index names
↳ `virtual`	boolean	Whether the index is a virtual replica
`nbPages`	number	Total number of pages of indices

`algolia_get_settings`

Retrieve the settings of an Algolia index

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia API Key
`indexName`	string	是	Name of the Algolia index

输出

参数	类型	描述
`searchableAttributes`	array	List of searchable attributes
`attributesForFaceting`	array	Attributes used for faceting
`ranking`	array	Ranking criteria
`customRanking`	array	Custom ranking criteria
`replicas`	array	List of replica index names
`hitsPerPage`	number	Default number of hits per page
`maxValuesPerFacet`	number	Maximum number of facet values returned
`highlightPreTag`	string	HTML tag inserted before highlighted parts
`highlightPostTag`	string	HTML tag inserted after highlighted parts
`paginationLimitedTo`	number	Maximum number of hits accessible via pagination

`algolia_update_settings`

Update the settings of an Algolia index

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia Admin API Key (must have editSettings ACL)
`indexName`	string	是	Name of the Algolia index
`settings`	json	是	JSON object with settings to update (e.g., {"searchableAttributes": ["name", "description"], "customRanking": ["desc(popularity)"]})
`forwardToReplicas`	boolean	否	Whether to apply changes to replica indices (default: false)

输出

参数	类型	描述
`taskID`	number	Algolia task ID for tracking the settings update
`updatedAt`	string	Timestamp when the settings were updated

`algolia_delete_index`

Delete an entire Algolia index and all its records

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia Admin API Key (must have deleteIndex ACL)
`indexName`	string	是	Name of the Algolia index to delete

输出

参数	类型	描述
`taskID`	number	Algolia task ID for tracking the index deletion
`deletedAt`	string	Timestamp when the index was deleted

`algolia_copy_move_index`

Copy or move an Algolia index to a new destination

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia Admin API Key
`indexName`	string	是	Name of the source index
`operation`	string	是	Operation to perform: "copy" or "move"
`destination`	string	是	Name of the destination index
`scope`	json	否	Array of scopes to copy (only for "copy" operation): ["settings", "synonyms", "rules"]. Omit to copy everything including records.

输出

参数	类型	描述
`taskID`	number	Algolia task ID for tracking the copy/move operation
`updatedAt`	string	Timestamp when the operation was performed

`algolia_clear_records`

Clear all records from an Algolia index while keeping settings, synonyms, and rules

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia Admin API Key (must have deleteIndex ACL)
`indexName`	string	是	Name of the Algolia index to clear

输出

参数	类型	描述
`taskID`	number	Algolia task ID for tracking the clear operation
`updatedAt`	string	Timestamp when the records were cleared

`algolia_delete_by_filter`

Delete all records matching a filter from an Algolia index

输入

参数	类型	必填	描述
`applicationId`	string	是	Algolia Application ID
`apiKey`	string	是	Algolia Admin API Key (must have deleteIndex ACL)
`indexName`	string	是	Name of the Algolia index
`filters`	string	否	Filter expression to match records for deletion (e.g., "category:outdated")
`facetFilters`	json	否	Array of facet filters (e.g., ["brand:Acme"])
`numericFilters`	json	否	Array of numeric filters (e.g., ["price > 100"])
`tagFilters`	json	否	Array of tag filters using the _tags attribute (e.g., ["published"])
`aroundLatLng`	string	否	Coordinates for geo-search filter (e.g., "40.71,-74.01")
`aroundRadius`	number	否	Maximum radius in meters for geo-search, or "all" for unlimited
`insideBoundingBox`	json	否	Bounding box coordinates as [[lat1, lng1, lat2, lng2]] for geo-search filter
`insidePolygon`	json	否	Polygon coordinates as [[lat1, lng1, lat2, lng2, lat3, lng3, ...]] for geo-search filter

输出

参数	类型	描述
`taskID`	number	Algolia task ID for tracking the delete-by-filter operation
`updatedAt`	string	Timestamp when the operation was performed

Algolia

On this page