[AI] [Agents] sync to file purpose cleanup TypeSpec (#41104)

* [AI] [Agents] sync to file purpose cleanup TypeSpec

* update patch files doc strings

* update aio patch doc strings

* Update sdk/ai/azure-ai-agents/azure/ai/agents/aio/operations/_patch.py

Co-authored-by: Copilot <[email protected]>

* Update sdk/ai/azure-ai-agents/azure/ai/agents/aio/operations/_patch.py

Co-authored-by: Copilot <[email protected]>

* Update sdk/ai/azure-ai-agents/azure/ai/agents/aio/operations/_patch.py

Co-authored-by: Copilot <[email protected]>

* Update sdk/ai/azure-ai-agents/azure/ai/agents/operations/_patch.py

Co-authored-by: Copilot <[email protected]>

* typos

---------

Co-authored-by: Copilot <[email protected]>

Author: glharper

sdk/ai/azure-ai-agents/azure/ai/agents/aio/operations/_operations.py

@@ -2306,9 +2306,8 @@ async def list(
     ) -> _models.FileListResponse:
         """Gets a list of previously uploaded files.
 
-        :keyword purpose: The purpose of the file. Known values are: "fine-tune", "fine-tune-results",
-         "assistants", "assistants_output", "batch", "batch_output", and "vision". Default value is
-         None.
+        :keyword purpose: The purpose of the file. Known values are: "assistants", "assistants_output",
+         and "vision". Default value is None.
         :paramtype purpose: str or ~azure.ai.agents.models.FilePurpose
         :return: FileListResponse. The FileListResponse is compatible with MutableMapping
         :rtype: ~azure.ai.agents.models.FileListResponse

sdk/ai/azure-ai-agents/azure/ai/agents/aio/operations/_patch.py

@@ -1306,8 +1306,7 @@ async def upload(  # pylint: disable=arguments-differ
 
         :keyword file_path: Required.
         :type file_path: str
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-         "assistants_output", "batch", "batch_output", and "vision". Required.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". Required.
         :paramtype purpose: str or ~azure.ai.agents.models.FilePurpose
         :return: FileInfo. The FileInfo is compatible with MutableMapping
         :rtype: ~azure.ai.agents.models.FileInfo
@@ -1323,8 +1322,7 @@ async def upload(  # pylint: disable=arguments-differ
 
         :keyword file: Required.
         :paramtype file: ~azure.ai.agents._vendor.FileType
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-         "assistants_output", "batch", "batch_output", and "vision". Required.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". Required.
         :paramtype purpose: str or ~azure.ai.agents.models.FilePurpose
         :keyword filename: Default value is None.
         :paramtype filename: str
@@ -1364,8 +1362,8 @@ async def upload(
         :paramtype file: Optional[FileType]
         :keyword file_path: Path to the file. Required if `body` and `purpose` are not provided.
         :paramtype file_path: Optional[str]
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-            "assistants_output", "batch", "batch_output", and "vision". Required if `body` and `file` are not provided.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". 
+            Required if `body` and `file` are not provided.
         :paramtype purpose: Union[str, _models.FilePurpose, None]
         :keyword filename: The name of the file.
         :paramtype filename: Optional[str]
@@ -1440,8 +1438,7 @@ async def upload_and_poll(
 
         :keyword file: Required.
         :paramtype file: ~azure.ai.agents._vendor.FileType
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-         "assistants_output", "batch", "batch_output", and "vision". Required.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". Required.
         :paramtype purpose: str or ~azure.ai.agents.models.FilePurpose
         :keyword filename: Default value is None.
         :paramtype filename: str
@@ -1470,8 +1467,7 @@ async def upload_and_poll(
 
         :keyword file_path: Required.
         :type file_path: str
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-         "assistants_output", "batch", "batch_output", and "vision". Required.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". Required.
         :paramtype purpose: str or ~azure.ai.agents.models.FilePurpose
         :keyword polling_interval: Time to wait before polling for the status of the uploaded file. Default value
          is 1.
@@ -1506,8 +1502,8 @@ async def upload_and_poll(
         :paramtype file: Optional[FileType]
         :keyword file_path: Path to the file. Required if `body` and `purpose` are not provided.
         :paramtype file_path: Optional[str]
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-            "assistants_output", "batch", "batch_output", and "vision". Required if `body` and `file` are not provided.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". 
+            Required if `body` and `file` are not provided.
         :paramtype purpose: Union[str, _models.FilePurpose, None]
         :keyword filename: The name of the file.
         :paramtype filename: Optional[str]

sdk/ai/azure-ai-agents/azure/ai/agents/models/_enums.py

@@ -157,18 +157,10 @@ class ErrorEvent(str, Enum, metaclass=CaseInsensitiveEnumMeta):
 class FilePurpose(str, Enum, metaclass=CaseInsensitiveEnumMeta):
     """The possible values denoting the intended usage of a file."""
 
-    FINE_TUNE = "fine-tune"
-    """Indicates a file is used for fine tuning input."""
-    FINE_TUNE_RESULTS = "fine-tune-results"
-    """Indicates a file is used for fine tuning results."""
     AGENTS = "assistants"
     """Indicates a file is used as input to agents."""
     AGENTS_OUTPUT = "assistants_output"
     """Indicates a file is used as output by agents."""
-    BATCH = "batch"
-    """Indicates a file is used as input to ."""
-    BATCH_OUTPUT = "batch_output"
-    """Indicates a file is used as output by a vector store batch operation."""
     VISION = "vision"
     """Indicates a file is used as input to a vision operation."""
 

sdk/ai/azure-ai-agents/azure/ai/agents/models/_models.py

@@ -1073,8 +1073,8 @@ class FileInfo(_Model):
     :ivar created_at: The Unix timestamp, in seconds, representing when this object was created.
      Required.
     :vartype created_at: ~datetime.datetime
-    :ivar purpose: The intended purpose of a file. Required. Known values are: "fine-tune",
-     "fine-tune-results", "assistants", "assistants_output", "batch", "batch_output", and "vision".
+    :ivar purpose: The intended purpose of a file. Required. Known values are: "assistants",
+     "assistants_output", and "vision".
     :vartype purpose: str or ~azure.ai.agents.models.FilePurpose
     :ivar status: The state of the file. This field is available in Azure OpenAI only. Known values
      are: "uploaded", "pending", "running", "processed", "error", "deleting", and "deleted".
@@ -1097,9 +1097,8 @@ class FileInfo(_Model):
     )
     """The Unix timestamp, in seconds, representing when this object was created. Required."""
     purpose: Union[str, "_models.FilePurpose"] = rest_field(visibility=["read", "create", "update", "delete", "query"])
-    """The intended purpose of a file. Required. Known values are: \"fine-tune\",
-     \"fine-tune-results\", \"assistants\", \"assistants_output\", \"batch\", \"batch_output\", and
-     \"vision\"."""
+    """The intended purpose of a file. Required. Known values are: \"assistants\",
+     \"assistants_output\", and \"vision\"."""
     status: Optional[Union[str, "_models.FileState"]] = rest_field(
         visibility=["read", "create", "update", "delete", "query"]
     )
@@ -5496,8 +5495,8 @@ class UploadFileRequest(_Model):
     :vartype file: ~azure.ai.agents._utils.utils.FileType
     :ivar purpose: The intended purpose of the uploaded file. Use ``assistants`` for Agents and
      Message files, ``vision`` for Agents image file inputs, ``batch`` for Batch API, and
-     ``fine-tune`` for Fine-tuning. Required. Known values are: "fine-tune", "fine-tune-results",
-     "assistants", "assistants_output", "batch", "batch_output", and "vision".
+     ``fine-tune`` for Fine-tuning. Required. Known values are: "assistants", "assistants_output",
+     and "vision".
     :vartype purpose: str or ~azure.ai.agents.models.FilePurpose
     :ivar filename: The name of the file.
     :vartype filename: str
@@ -5510,8 +5509,7 @@ class UploadFileRequest(_Model):
     purpose: Union[str, "_models.FilePurpose"] = rest_field(visibility=["read", "create", "update", "delete", "query"])
     """The intended purpose of the uploaded file. Use ``assistants`` for Agents and Message files,
      ``vision`` for Agents image file inputs, ``batch`` for Batch API, and ``fine-tune`` for
-     Fine-tuning. Required. Known values are: \"fine-tune\", \"fine-tune-results\", \"assistants\",
-     \"assistants_output\", \"batch\", \"batch_output\", and \"vision\"."""
+     Fine-tuning. Required. Known values are: \"assistants\", \"assistants_output\", and \"vision\"."""
     filename: Optional[str] = rest_field(visibility=["read", "create", "update", "delete", "query"])
     """The name of the file."""
 

sdk/ai/azure-ai-agents/azure/ai/agents/operations/_operations.py

@@ -3411,9 +3411,8 @@ def list(
     ) -> _models.FileListResponse:
         """Gets a list of previously uploaded files.
 
-        :keyword purpose: The purpose of the file. Known values are: "fine-tune", "fine-tune-results",
-         "assistants", "assistants_output", "batch", "batch_output", and "vision". Default value is
-         None.
+        :keyword purpose: The purpose of the file. Known values are: "assistants", "assistants_output",
+         and "vision". Default value is None.
         :paramtype purpose: str or ~azure.ai.agents.models.FilePurpose
         :return: FileListResponse. The FileListResponse is compatible with MutableMapping
         :rtype: ~azure.ai.agents.models.FileListResponse

sdk/ai/azure-ai-agents/azure/ai/agents/operations/_patch.py

@@ -1316,8 +1316,7 @@ def upload(  # pylint: disable=arguments-differ
 
         :keyword file_path: Required.
         :type file_path: str
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-         "assistants_output", "batch", "batch_output", and "vision". Required.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". Required.
         :paramtype purpose: str or ~azure.ai.agents.models.FilePurpose
         :return: FileInfo. The FileInfo is compatible with MutableMapping
         :rtype: ~azure.ai.agents.models.FileInfo
@@ -1333,8 +1332,7 @@ def upload(  # pylint: disable=arguments-differ
 
         :keyword file: Required.
         :paramtype file: ~azure.ai.agents._vendor.FileType
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-         "assistants_output", "batch", "batch_output", and "vision". Required.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". Required.
         :paramtype purpose: str or ~azure.ai.agents.models.FilePurpose
         :keyword filename: Default value is None.
         :paramtype filename: str
@@ -1374,8 +1372,8 @@ def upload(
         :paramtype file: Optional[FileType]
         :keyword file_path: Path to the file. Required if `body` and `purpose` are not provided.
         :paramtype file_path: Optional[str]
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-            "assistants_output", "batch", "batch_output", and "vision". Required if `body` and `file` are not provided.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". 
+            Required if `body` and `file` are not provided.
         :paramtype purpose: Union[str, _models.FilePurpose, None]
         :keyword filename: The name of the file.
         :paramtype filename: Optional[str]
@@ -1450,8 +1448,7 @@ def upload_and_poll(
 
         :keyword file: Required.
         :paramtype file: ~azure.ai.agents._vendor.FileType
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-         "assistants_output", "batch", "batch_output", and "vision". Required.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". Required.
         :paramtype purpose: str or ~azure.ai.agents.models.FilePurpose
         :keyword filename: Default value is None.
         :paramtype filename: str
@@ -1480,8 +1477,7 @@ def upload_and_poll(
 
         :keyword file_path: Required.
         :type file_path: str
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-         "assistants_output", "batch", "batch_output", and "vision". Required.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". Required.
         :paramtype purpose: str or ~azure.ai.agents.models.FilePurpose
         :keyword polling_interval: Time to wait before polling for the status of the uploaded file. Default value
          is 1.
@@ -1516,8 +1512,8 @@ def upload_and_poll(
         :paramtype file: Optional[FileType]
         :keyword file_path: Path to the file. Required if `body` and `purpose` are not provided.
         :paramtype file_path: Optional[str]
-        :keyword purpose: Known values are: "fine-tune", "fine-tune-results", "assistants",
-            "assistants_output", "batch", "batch_output", and "vision". Required if `body` and `file` are not provided.
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". 
+            Required if `body` and `file` are not provided.
         :paramtype purpose: Union[str, _models.FilePurpose, None]
         :keyword filename: The name of the file.
         :paramtype filename: Optional[str]

sdk/ai/azure-ai-agents/tsp-location.yaml

@@ -1,4 +1,4 @@
 directory: specification/ai/Azure.AI.Agents
-commit: b9b2b55cc99daf6e107471448a281a03e83884ec
+commit: 9cfa4c5aa42ef81a9f7d1d324402427f2507d61d
 repo: Azure/azure-rest-api-specs
 additionalDirectories: