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

# LogSpanRetrievalContent

# LogSpanRetrievalContent

Content type for RAG and vector database query spans.

## Overview

`LogSpanRetrievalContent` captures retrieval operations such as vector similarity searches and document lookups. It is wrapped in a [LogSpanContent](/docs/reference/sdk/v2/python/types/LogSpanContent) union via the `actual_instance` pattern.

```python theme={null}
from adaline_api.models.log_span_retrieval_content import LogSpanRetrievalContent
```

***

## Fields

<ParamField body="type" type="str" required>
  Must be `"Retrieval"`.
</ParamField>

<ParamField body="input" type="str" required>
  The input payload as a JSON string. Must be valid, parseable JSON (the result of `json.dumps()`).
</ParamField>

<ParamField body="output" type="str" required>
  The output payload as a JSON string. Must be valid, parseable JSON (the result of `json.dumps()`).
</ParamField>

***

## Construction Pattern

All span content is wrapped in [LogSpanContent](/docs/reference/sdk/v2/python/types/LogSpanContent) using the `actual_instance` parameter:

```python theme={null}
from adaline_api.models.log_span_content import LogSpanContent
from adaline_api.models.log_span_retrieval_content import LogSpanRetrievalContent

content = LogSpanContent(
    actual_instance=LogSpanRetrievalContent(
        type="Retrieval",
        input=json.dumps({"query": "How does auth work?", "top_k": 5}),
        output=json.dumps({"documents": [{"id": "doc1", "score": 0.95}]}),
    )
)
```

***

## Example

```python theme={null}
import json
from adaline_api.models.log_span_content import LogSpanContent
from adaline_api.models.log_span_retrieval_content import LogSpanRetrievalContent

retrieval_input = {"query": "refund policy", "top_k": 3, "namespace": "support"}
retrieval_output = {
    "documents": [
        {"id": "doc_42", "score": 0.97, "text": "Refunds are processed within 5 days."},
        {"id": "doc_18", "score": 0.91, "text": "Contact support for refund requests."},
    ]
}

span.update({
    "status": "success",
    "content": LogSpanContent(
        actual_instance=LogSpanRetrievalContent(
            type="Retrieval",
            input=json.dumps(retrieval_input),
            output=json.dumps(retrieval_output),
        )
    ),
})
```