# ovok_sdk.resources.ai

Canonical page: https://docs.ovok.com/python-sdk/reference/resources/ai

AI features: translation, natural-language FHIR search and chat.

## ChatSessionsResource [#chatsessionsresource]

```python
ChatSessionsResource(http: HttpClient)
```

AI chat sessions; access it as `ovok.ai.chat.sessions`.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `http` | `HttpClient` |  | The HTTP client scoped to the AI routes. |

### create() [#create]

```python
create(body: Resource) -> Resource
```

Start a chat session.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `body` | `Resource` |  | The session as the API takes it. |

**Returns**

- `Resource`: The created session.

### list() [#list]

```python
list(params: QueryParams | None = None) -> Resource
```

List chat sessions.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `params` | `QueryParams \| None` | `None` | Optional query parameters passed to the API. |

**Returns**

- `Resource`: The API's list response.

### retrieve() [#retrieve]

```python
retrieve(session_id: str, params: QueryParams | None = None) -> Resource
```

Read one chat session.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `session_id` | `str` |  | The session ID. |
| `params` | `QueryParams \| None` | `None` | Optional query parameters passed to the API. |

**Returns**

- `Resource`: The session.

## ChatMessagesResource [#chatmessagesresource]

```python
ChatMessagesResource(http: HttpClient)
```

Messages in an AI chat session; access it as `ovok.ai.chat.messages`.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `http` | `HttpClient` |  | The HTTP client scoped to the AI routes. |

### list() [#list-1]

```python
list(session_id: str, params: QueryParams | None = None) -> Resource
```

List a session's messages.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `session_id` | `str` |  | The session ID. |
| `params` | `QueryParams \| None` | `None` | Optional query parameters passed to the API. |

**Returns**

- `Resource`: The API's list response.

### send() [#send]

```python
send(session_id: str, body: Resource) -> Resource
```

Send a message to a session.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `session_id` | `str` |  | The session ID. |
| `body` | `Resource` |  | The message as the API takes it. |

**Returns**

- `Resource`: The API's reply.

## AiChatResource [#aichatresource]

```python
AiChatResource(http: HttpClient)
```

AI chat sessions and their messages; access it as `ovok.ai.chat`.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `http` | `HttpClient` |  | The HTTP client scoped to the AI routes. |

## AiResource [#airesource]

```python
AiResource(http: HttpClient)
```

Translation, natural-language FHIR search and chat.

Created by `Ovok`; access it as `ovok.ai`.

### translate() [#translate]

```python
translate(body: Resource) -> Resource
```

Translate text.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `body` | `Resource` |  | The translation request as the API takes it. |

**Returns**

- `Resource`: The translation.

### fhir_search() [#fhir_search]

```python
fhir_search(body: Resource) -> Resource
```

Search FHIR data with a natural-language query.

**Parameters**

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| `body` | `Resource` |  | The search request as the API takes it. |

**Returns**

- `Resource`: The search result.