async_openai/skills/
skill_versions.rs

1use bytes::Bytes;
2
3use crate::{
4    config::Config,
5    error::OpenAIError,
6    types::skills::{
7        CreateSkillVersionRequest, DeletedSkillVersionResource, SkillVersionListResource,
8        SkillVersionResource,
9    },
10    Client, RequestOptions,
11};
12
13/// Create and manage skill versions.
14pub struct SkillVersions<'c, C: Config> {
15    client: &'c Client<C>,
16    skill_id: String,
17    pub(crate) request_options: RequestOptions,
18}
19
20impl<'c, C: Config> SkillVersions<'c, C> {
21    pub fn new(client: &'c Client<C>, skill_id: &str) -> Self {
22        Self {
23            client,
24            skill_id: skill_id.to_string(),
25            request_options: RequestOptions::new(),
26        }
27    }
28
29    /// Create a new immutable skill version by uploading files.
30    #[crate::byot(
31        T0 = Clone,
32        R = serde::de::DeserializeOwned,
33        where_clause = "reqwest::multipart::Form: crate::traits::AsyncTryFrom<T0, Error = OpenAIError>",
34    )]
35    pub async fn create(
36        &self,
37        request: CreateSkillVersionRequest,
38    ) -> Result<SkillVersionResource, OpenAIError> {
39        self.client
40            .post_form(
41                &format!("/skills/{}/versions", self.skill_id),
42                request,
43                &self.request_options,
44            )
45            .await
46    }
47
48    /// List skill versions.
49    #[crate::byot(R = serde::de::DeserializeOwned)]
50    pub async fn list(&self) -> Result<SkillVersionListResource, OpenAIError> {
51        self.client
52            .get(
53                &format!("/skills/{}/versions", self.skill_id),
54                &self.request_options,
55            )
56            .await
57    }
58
59    /// Retrieve a specific skill version.
60    #[crate::byot(T0 = std::fmt::Display, R = serde::de::DeserializeOwned)]
61    pub async fn retrieve(&self, version: &str) -> Result<SkillVersionResource, OpenAIError> {
62        self.client
63            .get(
64                format!("/skills/{}/versions/{version}", self.skill_id).as_str(),
65                &self.request_options,
66            )
67            .await
68    }
69
70    /// Delete a skill version.
71    #[crate::byot(T0 = std::fmt::Display, R = serde::de::DeserializeOwned)]
72    pub async fn delete(&self, version: &str) -> Result<DeletedSkillVersionResource, OpenAIError> {
73        self.client
74            .delete(
75                format!("/skills/{}/versions/{version}", self.skill_id).as_str(),
76                &self.request_options,
77            )
78            .await
79    }
80
81    /// Download a skill version zip bundle.
82    pub async fn content(&self, version: &str) -> Result<Bytes, OpenAIError> {
83        let (bytes, _headers) = self
84            .client
85            .get_raw(
86                format!("/skills/{}/versions/{version}/content", self.skill_id).as_str(),
87                &self.request_options,
88            )
89            .await?;
90        Ok(bytes)
91    }
92}
async_openai/skills/skill_versions.rs

async_openai/skills/
skill_versions.rs
