---
title: intent | CodeWeaver Docs
description: API reference for codeweaver.server.agent_api.search.intent
url: "https://docs.knitli.com/api/server/agent_api/search/intent"
type: static
generatedAt: "2026-04-17T17:21:09.670Z"
---

# intent
       [Open in ChatGPT](https://chatgpt.com/?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[Open in Claude](https://claude.ai/new?q=Read%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F.%20I%20want%20to%20ask%20questions%20about%20it.)[View in Markdown](/codeweaver/api/server/agent_api/search/intent.md)       [Share on LinkedIn](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F)[Share on X](https://x.com/intent/tweet?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F&text=intent)[Share on Threads](https://threads.net/intent/post?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F&text=intent)[Share on Bluesky](https://bsky.app/intent/compose?text=intent%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F)[Share on Facebook](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F)[Share on Reddit](https://reddit.com/submit?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F&title=intent)[Share on Hacker News](https://news.ycombinator.com/submitlink?u=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F&t=intent)[Share on Email](mailto:?subject=intent&body=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F)[Share on WhatsApp](https://wa.me/?text=intent%20https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F)[Share on Telegram](https://t.me/share/url?url=https%3A%2F%2Fdocs.knitli.com%2Fcodeweaver%2Fapi%2Fserver%2Fagent_api%2Fsearch%2Fintent%2F&text=intent)
# `codeweaver.server.agent_api.search.intent`
[Section titled “codeweaver.server.agent_api.search.intent”](#codeweaverserveragent_apisearchintent)
Intent classification models for query analysis.

## Class: `IntentResult`
[Section titled “Class: IntentResult”](#class-intentresult)
Result of intent analysis with strategy recommendations.

## Class: `IntentType`
[Section titled “Class: IntentType”](#class-intenttype)
Enumeration of intent types.

## Class: `QueryComplexity`
[Section titled “Class: QueryComplexity”](#class-querycomplexity)
Enumeration of query complexity levels.

### Method: `default`
[Section titled “Method: default”](#method-default)

**

```
default()
```

Return the default query complexity level.

## Class: `QueryIntent`
[Section titled “Class: QueryIntent”](#class-queryintent)
Classified query intent with confidence scoring.

## Function: `detect_intent`
[Section titled “Function: detect_intent”](#function-detect_intent)

**

```
detect_intent()
```

Analyze query and return intent classification with confidence.

Uses keyword-based heuristics for v0.1 (agent-driven analysis planned for v0.2).

Args: query: Search query string to analyze

Returns: QueryIntent with detected intent_type, confidence score, reasoning, and metadata

Examples: >>> detect_intent(“how does authentication work”) QueryIntent(intent_type=IntentType.UNDERSTAND, confidence=0.9, …)

>>> detect_intent(“fix login bug”) QueryIntent(intent_type=IntentType.DEBUG, confidence=0.9, …)

>>> detect_intent(“add user registration”) QueryIntent(intent_type=IntentType.IMPLEMENT, confidence=0.9, …)