Tool details
| Field | Value |
|---|---|
| Name | search_knowledge |
| Group | Knowledge |
Playground
Input schema
input-schema.json
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"description": "Text to match against knowledge frontmatter. On the first request, provide query without cursor."
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 13334,
"description": "Opaque pagination token. Omit on the first request. To continue, repeat the same original query and pass page_info.next from the previous response as cursor."
},
"lookup_target": {
"anyOf": [
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "preview_branch",
"description": "Provide the kind."
},
"branch_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"description": "Branch identifier. Use null for the main branch when the tool supports it."
},
{
"type": "null",
"description": "Branch identifier. Use null for the main branch when the tool supports it."
}
],
"description": "Branch to search. Omit or use null for the main branch (the default)."
}
},
"required": [
"kind"
],
"additionalProperties": false,
"description": "Search a working branch, the default scope when lookup_target is omitted."
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "environment",
"description": "Provide the kind."
},
"environment_id": {
"type": "string",
"format": "uuid",
"description": "ID of the environment whose deployed release to search."
},
"environment_name": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Name of the environment (for example \"production\") whose deployed release to search."
}
},
"required": [
"kind"
],
"additionalProperties": false,
"description": "Search the release currently deployed to an environment. Provide environment_id or environment_name."
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "release",
"description": "Provide the kind."
},
"release_id": {
"type": "string",
"format": "uuid",
"description": "ID of the release to search."
},
"release_version": {
"type": "string",
"minLength": 1,
"maxLength": 255,
"description": "Version string of the release to search."
}
},
"required": [
"kind"
],
"additionalProperties": false,
"description": "Search a specific published release. Provide release_id or release_version."
}
],
"description": "Optional. Omit to search the current branch (the default). Only set this to target a specific deployed environment or release."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 12,
"description": "Maximum number of results to return."
},
"shard_count": {
"type": "integer",
"minimum": 1,
"maximum": 8,
"description": "Provide the shard count."
},
"shard_index": {
"type": "integer",
"minimum": 0,
"description": "Provide the shard index."
},
"project_reference": {
"type": "string",
"description": "Project identifier or slug that scopes the tool call."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"description": "Input schema for the search_knowledge tool."
}
Output schema
output-schema.json
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Query string associated with this result."
},
"mode": {
"type": "string",
"enum": [
"search",
"browse"
],
"description": "The mode associated with this tool result."
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "The path associated with this tool result."
},
"matched_fields": {
"type": "array",
"items": {
"type": "string",
"description": "One matched field item associated with this tool result."
},
"description": "List of matched fields associated with this tool result."
},
"frontmatter": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "The key associated with this tool result."
},
"value": {
"type": "string",
"description": "The value associated with this tool result."
}
},
"required": [
"key",
"value"
],
"additionalProperties": false,
"description": "One frontmatter item associated with this tool result."
},
"description": "List of frontmatter associated with this tool result."
}
},
"required": [
"path",
"matched_fields",
"frontmatter"
],
"additionalProperties": false,
"description": "One data item associated with this tool result."
},
"description": "Primary result records returned by the tool."
},
"page_info": {
"type": "object",
"properties": {
"self": {
"type": [
"string",
"null"
],
"description": "Cursor that refers to the current page."
},
"first": {
"type": "object",
"description": "The first associated with this tool result."
},
"next": {
"type": [
"string",
"null"
],
"description": "Cursor for the next page when pagination is available."
},
"prev": {
"type": [
"string",
"null"
],
"description": "Cursor for the previous page when pagination is available."
}
},
"required": [
"self",
"first",
"next",
"prev"
],
"additionalProperties": false,
"description": "Pagination cursor values for traversing the result set."
},
"returned": {
"type": "integer",
"minimum": 0,
"description": "The returned associated with this tool result."
},
"total_matches": {
"type": "integer",
"minimum": 0,
"description": "Total number of matches found by the tool."
},
"shard": {
"type": "object",
"properties": {
"shard_index": {
"type": "integer",
"minimum": 0,
"description": "The shard index associated with this tool result."
},
"shard_count": {
"type": "integer",
"minimum": 1,
"description": "The shard count associated with this tool result."
},
"total_items": {
"type": "integer",
"minimum": 0,
"description": "The total items associated with this tool result."
}
},
"required": [
"shard_index",
"shard_count",
"total_items"
],
"additionalProperties": false,
"description": "Structured shard details associated with this tool result."
}
},
"required": [
"query",
"mode",
"data",
"page_info",
"returned",
"total_matches",
"shard"
],
"additionalProperties": false,
"description": "Structured result returned by the search_knowledge tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}