Title100/100
Microsoft Docs Search
The title clearly communicates the tool’s action and subject. Keep it concise.
Description85/100
Search official Microsoft/Azure documentation to find the most relevant and trustworthy content for a user's query. This tool returns up to 10 high-quality content chunks (each max 500 tokens), extracted from Microsoft Learn and other official sources. Each result includes the article title, URL, and a self-contained content excerpt optimized for fast retrieval and reasoning. Always use this tool to quickly ground your answers in accurate, first-party Microsoft/Azure knowledge. ## Follow-up Pattern To ensure completeness, use microsoft_docs_fetch when high-value pages are identified by search. The fetch tool complements search by providing the full detail. This is a required step for comprehensive results.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
a query or topic about Microsoft/Azure products, services, platforms, developer tools, frameworks, or APIs
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations75/100
Declare openWorldHint based on the tool’s actual behavior.
{
"title": "Microsoft Docs Search",
"readOnlyHint": true,
"idempotentHint": true,
"destructiveHint": false
}Output schema62/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"content": {
"type": [
"string",
"null"
]
},
"contentUrl": {
"type": "string"
},
"extensionData": {
"type": [
"object",
"null"
]
},
"content_omitted": {
"type": "boolean"
}
}
}
}
}
}