file search

Author: giles17

agent-framework/user-guide/agents/agent-types/azure-openai-responses-agent.md

@@ -351,6 +351,63 @@ async def main():
 asyncio.run(main())
 ```
 
+### File Search
+
+Enable your agent to search through uploaded documents and files:
+
+```python
+import asyncio
+from agent_framework import ChatAgent, HostedFileSearchTool, HostedVectorStoreContent
+from agent_framework.azure import AzureOpenAIResponsesClient
+from azure.identity import AzureCliCredential
+
+async def create_vector_store(client: AzureOpenAIResponsesClient) -> tuple[str, HostedVectorStoreContent]:
+    """Create a vector store with sample documents."""
+    file = await client.client.files.create(
+        file=("todays_weather.txt", b"The weather today is sunny with a high of 75F."), 
+        purpose="assistants"
+    )
+    vector_store = await client.client.vector_stores.create(
+        name="knowledge_base",
+        expires_after={"anchor": "last_active_at", "days": 1},
+    )
+    result = await client.client.vector_stores.files.create_and_poll(
+        vector_store_id=vector_store.id, 
+        file_id=file.id
+    )
+    if result.last_error is not None:
+        raise Exception(f"Vector store file processing failed with status: {result.last_error.message}")
+
+    return file.id, HostedVectorStoreContent(vector_store_id=vector_store.id)
+
+async def delete_vector_store(client: AzureOpenAIResponsesClient, file_id: str, vector_store_id: str) -> None:
+    """Delete the vector store after using it."""
+    await client.client.vector_stores.delete(vector_store_id=vector_store_id)
+    await client.client.files.delete(file_id=file_id)
+
+async def main():
+    print("=== Azure OpenAI Responses Client with File Search Example ===\n")
+
+    # Initialize Responses client
+    client = AzureOpenAIResponsesClient(credential=AzureCliCredential())
+
+    file_id, vector_store = await create_vector_store(client)
+
+    async with ChatAgent(
+        chat_client=client,
+        instructions="You are a helpful assistant that can search through files to find information.",
+        tools=[HostedFileSearchTool(inputs=vector_store)],
+    ) as agent:
+        query = "What is the weather today? Do a file search to find the answer."
+        print(f"User: {query}")
+        result = await agent.run(query)
+        print(f"Agent: {result}\n")
+
+    await delete_vector_store(client, file_id, vector_store.vector_store_id)
+
+asyncio.run(main())
+```
+
 ### Model Context Protocol (MCP) Tools
 
 #### Local MCP Tools