feat:convenient to access output text for response api (64bit#463)

(cherry picked from commit 8e9639a)

Author: Dragon-GCS

async-openai/src/types/responses/response.rs

@@ -2347,6 +2347,36 @@ pub struct Response {
     pub usage: Option<ResponseUsage>,
 }
 
+impl Response {
+    /// SDK-only convenience property that contains the aggregated text output from all
+    /// `output_text` items in the `output` array, if any are present.
+    pub fn output_text(&self) -> Option<String> {
+        let output = self
+            .output
+            .iter()
+            .filter_map(|item| match item {
+                OutputItem::Message(msg) => Some(
+                    msg.content
+                        .iter()
+                        .filter_map(|content| match content {
+                            OutputMessageContent::OutputText(ot) => Some(ot.text.clone()),
+                            _ => None,
+                        })
+                        .collect::<Vec<String>>(),
+                ),
+                _ => None,
+            })
+            .flatten()
+            .collect::<Vec<String>>()
+            .join("");
+        if output.is_empty() {
+            None
+        } else {
+            Some(output)
+        }
+    }
+}
+
 #[derive(Debug, Serialize, Deserialize, Clone, PartialEq)]
 #[serde(rename_all = "snake_case")]
 pub enum Status {

examples/responses/src/main.rs

@@ -44,7 +44,9 @@ async fn main() -> Result<(), Box<dyn Error>> {
     println!("{}", serde_json::to_string(&request).unwrap());
 
     let response = client.responses().create(request).await?;
+    let output_text = response.output_text().unwrap_or("Empty text output".into());
 
+    println!("\nOutput Text: {output_text:?}\n",);
     for output in response.output {
         println!("\nOutput: {:?}\n", output);
     }