[Assistants] Support retrieve assistant file

Author: qianmoQ

docs/docs/reference/openai/assistants.md

@@ -27,7 +27,9 @@ AssistantsEntity entity = AssistantsEntity.builder()
         .model(CompletionModel.GPT_35_TURBO)
         .instructions("You are a personal math tutor. When asked a question, write and run Python code to answer the question.")
         .build();
-client.createAssistants(entity);
+client.
+
+createAssistants(entity);
 ```
 
 Returns:
@@ -58,7 +60,7 @@ Returns:
 Create an assistant file by attaching a File to an assistant.
 
 ```java
-client.createAssistantsFile("file-jNuKdx61rNQ0FUhuPFpMNmGZ", "asst_xv9N9dNXstuV8OVLElLqgV7U")
+client.createAssistantsFile("file-jNuKdx61rNQ0FUhuPFpMNmGZ","asst_xv9N9dNXstuV8OVLElLqgV7U")
 ```
 
 Returns:
@@ -85,7 +87,9 @@ client.listAssistants(null);
 QueryEntity configure = QueryEntity.builder()
         .limit(2)
         .build();
-client.assistants(configure);
+client.
+
+assistants(configure);
 ```
 
 Returns:
@@ -172,3 +176,24 @@ Returns:
   "metadata": {}
 }
 ```
+
+### Retrieve assistant file
+
+---
+
+Retrieves an assistant file.
+
+```java
+client.retrieveAssistantFile("asst_xv9N9dNXstuV8OVLElLqgV7U","file-jNuKdx61rNQ0FUhuPFpMNmGZ");
+```
+
+Returns:
+
+```json
+{
+  "id": "file-abc123",
+  "object": "assistant.file",
+  "created_at": 1699055364,
+  "assistant_id": "asst_abc123"
+}
+```

src/main/java/org/devlive/sdk/openai/DefaultApi.java

@@ -273,4 +273,11 @@ Single<AssistantsFileEntity> fetchCreateAssistantFile(@Url String url,
      */
     @GET
     Single<AssistantsEntity> fetchRetrieveAssistant(@Url String url);
+
+    /**
+     * Retrieves an AssistantFile.
+     * 检索助手文件。
+     */
+    @GET
+    Single<AssistantsFileEntity> fetchRetrieveAssistantFile(@Url String url);
 }

src/main/java/org/devlive/sdk/openai/DefaultClient.java

@@ -310,6 +310,13 @@ public AssistantsEntity retrieveAssistant(String assistantId)
                 .blockingGet();
     }
 
+    public AssistantsFileEntity retrieveAssistantFile(String assistantId, String fileId)
+    {
+        String url = String.format(ProviderUtils.getUrl(provider, UrlModel.FETCH_RETRIEVE_ASSISTANT_FILE), assistantId, fileId);
+        return this.api.fetchRetrieveAssistantFile(url)
+                .blockingGet();
+    }
+
     private ObjectMapper createObjectMapper()
     {
         ObjectMapper objectMapper = new ObjectMapper();

src/main/java/org/devlive/sdk/openai/model/UrlModel.java

@@ -22,5 +22,6 @@ public enum UrlModel
     FETCH_FINE_TUNING_JOBS_CANCEL,
     FETCH_ASSISTANTS,
     FETCH_ASSISTANTS_FILES,
-    FETCH_RETRIEVE_ASSISTANT
+    FETCH_RETRIEVE_ASSISTANT,
+    FETCH_RETRIEVE_ASSISTANT_FILE;
 }

src/main/java/org/devlive/sdk/openai/utils/ProviderUtils.java

@@ -60,6 +60,7 @@ public static String getUrl(ProviderModel provider, UrlModel model)
         DEFAULT_PROVIDER.put(UrlModel.FETCH_ASSISTANTS, "v1/assistants");
         DEFAULT_PROVIDER.put(UrlModel.FETCH_ASSISTANTS_FILES, "v1/assistants/%s/files");
         DEFAULT_PROVIDER.put(UrlModel.FETCH_RETRIEVE_ASSISTANT, "v1/assistants/%s");
+        DEFAULT_PROVIDER.put(UrlModel.FETCH_RETRIEVE_ASSISTANT_FILE, "v1/assistants/%s/files/%s");
 
         AZURE_PROVIDER.put(UrlModel.FETCH_COMPLETIONS, "completions");
         AZURE_PROVIDER.put(UrlModel.FETCH_CHAT_COMPLETIONS, "chat/completions");

src/test/java/org/devlive/sdk/openai/AssistantsTest.java

@@ -59,4 +59,10 @@ public void testRetrieveAssistants()
     {
         Assert.assertNotNull(client.retrieveAssistant("asst_xv9N9dNXstuV8OVLElLqgV7U"));
     }
+
+    @Test
+    public void testRetrieveAssistantsFile()
+    {
+        Assert.assertNotNull(client.retrieveAssistantFile("asst_xv9N9dNXstuV8OVLElLqgV7U", "file-jNuKdx61rNQ0FUhuPFpMNmGZ"));
+    }
 }