1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
use crate::Embed;
use crate::embeddings::{EmbeddingModel, EmbeddingsBuilder};
/// A provider client with embedding capabilities.
/// Clone is required for conversions between client types.
pub trait EmbeddingsClient {
/// The type of EmbeddingModel used by the Client
type EmbeddingModel: EmbeddingModel;
/// Create an embedding model with the given model.
///
/// # Example
/// ```
/// use rig::prelude::*;
/// use rig::providers::openai::{Client, self};
///
/// // Initialize the OpenAI client
/// let openai = Client::new("your-open-ai-api-key");
///
/// let embedding_model = openai.embedding_model(openai::TEXT_EMBEDDING_3_LARGE);
/// ```
fn embedding_model(&self, model: impl Into<String>) -> Self::EmbeddingModel;
/// Create an embedding model with the given model identifier string and the number of dimensions in the embedding generated by the model.
/// This is the suggested method if you need to use a model not included in
/// `Self::EmbeddingModel::Models`
///
/// # Example with OpenAI
/// ```
/// use rig::prelude::*;
/// use rig::providers::openai::{Client, self};
///
/// // Initialize the OpenAI client
/// let openai = Client::new("your-open-ai-api-key");
///
/// let embedding_model = openai.embedding_model("model-unknown-to-rig", 3072);
/// ```
fn embedding_model_with_ndims(
&self,
model: impl Into<String>,
ndims: usize,
) -> Self::EmbeddingModel;
/// Create an embedding builder with the given embedding model.
///
/// # Example with OpenAI
/// ```
/// use rig::prelude::*;
/// use rig::providers::openai::{Client, self};
///
/// // Initialize the OpenAI client
/// let openai = Client::new("your-open-ai-api-key");
///
/// let embeddings = openai.embeddings(openai::TEXT_EMBEDDING_3_LARGE)
/// .simple_document("doc0", "Hello, world!")
/// .simple_document("doc1", "Goodbye, world!")
/// .build()
/// .await
/// .expect("Failed to embed documents");
/// ```
fn embeddings<D: Embed>(
&self,
model: impl Into<String>,
) -> EmbeddingsBuilder<Self::EmbeddingModel, D> {
EmbeddingsBuilder::new(self.embedding_model(model))
}
/// Create an embedding builder with the given name and the number of dimensions in the embedding generated by the model.
///
/// # Example with OpenAI
/// ```
/// use rig::prelude::*;
/// use rig::providers::openai::{Client, self};
///
/// // Initialize the OpenAI client
/// let openai = Client::new("your-open-ai-api-key");
///
/// let embeddings = openai.embeddings_with_ndims(openai::TEXT_EMBEDDING_3_LARGE, 3072)
/// .simple_document("doc0", "Hello, world!")
/// .simple_document("doc1", "Goodbye, world!")
/// .build()
/// .await
/// .expect("Failed to embed documents");
/// ```
fn embeddings_with_ndims<D: Embed>(
&self,
model: &str,
ndims: usize,
) -> EmbeddingsBuilder<Self::EmbeddingModel, D> {
EmbeddingsBuilder::new(self.embedding_model_with_ndims(model, ndims))
}
}