> ## 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

<div className="flex items-center gap-2">
  <Badge color="purple">Method</Badge>
</div>

> This is a method of the [**ContextTraceEmitter**](../classes/ContextTraceEmitter) class in the [**context\_events**](../modules/context_events) 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

<ParamField query="agent_name" type="str" required={true}>
  Name of the agent searching knowledge
</ParamField>

<ParamField query="query" type="str" required={true}>
  Search query
</ParamField>

<ParamField query="result_count" type="int" required={true}>
  Number of results returned
</ParamField>

<ParamField query="sources" type="Optional" required={false}>
  List of source documents/files
</ParamField>

<ParamField query="top_score" type="Optional[float]" required={false}>
  Score of top result (if available)
</ParamField>

## Uses

* `ContextEvent`
* `time.time`

## Source

<Card title="View on GitHub" icon="github" href="https://github.com/MervinPraison/PraisonAI/blob/main/src/praisonai-agents/praisonaiagents/trace/context_events.py#L871">
  `praisonaiagents/trace/context_events.py` at line 871
</Card>

***

## Related Documentation

<CardGroup cols={2}>
  <Card title="Knowledge Concept" icon="book" href="/docs/docs/concepts/knowledge" />

  <Card title="Knowledge Overview" icon="database" href="/docs/docs/knowledge/overview" />

  <Card title="Knowledge Configuration" icon="gear" href="/docs/docs/configuration/knowledge-config" />

  <Card title="Chat with PDF" icon="file-pdf" href="/docs/docs/knowledge/chat-with-pdf" />
</CardGroup>