> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Search • AI Agent SDK

> knowledge_search: Emit knowledge search event for tracking knowledge retrieval.

# knowledge\_search

Method

> This is a method of the [**ContextTraceEmitter**](https://praison.ai/docs/sdk/reference/praisonaiagents/classes/ContextTraceEmitter.md) class in the [**context\_events**](https://praison.ai/docs/sdk/reference/praisonaiagents/modules/context_events.md) module.

Emit knowledge search event for tracking knowledge retrieval.

## Signature

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
def knowledge_search(agent_name: str, query: str, result_count: int, sources: Optional[List[str]], top_score: Optional[float]) -> None
```

## Parameters

**agent\_name** `str` *required*

Name of the agent searching knowledge

**query** `str` *required*

Search query

**result\_count** `int` *required*

Number of results returned

**sources** `Optional`

List of source documents/files

**top\_score** `Optional[float]`

Score of top result (if available)

## Uses

* `ContextEvent`
* `time.time`

## Source

> [card] [View on GitHub](https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/trace/context_events.py#L1453)
>
> `praisonaiagents/trace/context_events.py` at line 1453

***

## Related Documentation

> [card] [Knowledge Concept](https://praison.ai/docs/docs/concepts/knowledge)

> [card] [Knowledge Overview](https://praison.ai/docs/docs/knowledge/overview)

> [card] [Knowledge Configuration](https://praison.ai/docs/docs/configuration/knowledge-config)

> [card] [Chat with PDF](https://praison.ai/docs/docs/knowledge/chat-with-pdf)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.