Update to the new framework

Author: hnky

docs/.vitepress/config.mts

@@ -59,6 +59,53 @@ export default defineConfig({
           provider: 'local'
         }
       }
+    },
+    pt: {
+      label: 'Português',
+      lang: 'pt',
+      themeConfig: {
+        sidebar: [
+          { 
+            text: 'Bem-vindo',
+            items: [
+              { text: 'Começar', link: '/pt/index' },
+              { text: 'Sobre o workshop', link: '/pt/about' },
+            ]
+          },
+          {
+            text: 'Configuração',
+            items: [
+              { text: 'Configuração do Ambiente de Desenvolvimento', link: '/pt/dev-environment' }
+            ]
+          },
+          {
+            text: 'Workshop',
+            items: [
+              { text: '1. Configurar Microsoft Foundry', link: '/pt/1_microsoft-foundry' },
+              { text: '2. Crie seu primeiro agente', link: '/pt/2_create-agent' },
+              { text: '3. Adicionar instruções', link: '/pt/3_add-instructions' },
+              { text: '4. Adicionar conhecimento', link: '/pt/4_add-knowledge' },
+              { text: '5. Adicionar ferramenta de estimativa', link: '/pt/5_add-tool' },
+              { text: '6. Integração MCP', link: '/pt/6_add-mcp' },
+            ]
+          },
+          {
+            text: 'Recursos',
+            items: [
+              { text: 'Servidor MCP de Pizza', link: '/pt/pizza-mcp' },
+              { text: 'Azure Classroom', link: '/pt/get-azure' }
+            ]
+          },
+          { text: 'Licença', link: '/pt/license' },
+          { text: '✉️ Contato e Feedback', link: '/pt/contact-feedback' }
+        ],
+        socialLinks: [
+          { icon: 'github', link: 'https://github.com/GlobalAICommunity/agentcon-pizza-workshop' }
+        ],
+        search: {
+          provider: 'local'
+        }
+      }
     }
   },
   themeConfig: {

docs/2_create-agent.md

@@ -1,14 +1,14 @@
 # Create Your First Agent  
 
-In this chapter, we’ll walk through the process of creating your very first AI agent using the **Microsoft Foundry Agent Service**.  
-By the end, you’ll have a simple agent running locally that you can interact with in real time.  
+In this chapter, we'll walk through the process of creating your very first AI agent using the **Foundry Agent Service**.  
+By the end, you'll have a simple agent running locally that you can interact with in real time.  
 
 First switch back to the Github codespace environment you created earlier. Make sure the terminal pane is still opened on the **workshop** folder.
 
 
 ## Login to Azure  
 
-Before you can use the Microsoft Foundry Agent Service, you need to sign in to your Azure subscription.  
+Before you can use the Foundry Agent Service, you need to sign in to your Azure subscription.  
 
 Run the following command and follow the on-screen instructions. Use credentials that have access to your Microsoft Foundry resource:  
 
@@ -23,37 +23,34 @@ az login --use-device-code
 Next, install the Python packages needed to work with Microsoft Foundry and manage environment variables:  
 
 ```shell
-pip install azure-identity
-pip install azure-ai-projects
-pip install azure-ai-agents==1.2.0b5
-pip install jsonref
-pip install python-dotenv
+pip install openai azure-identity azure-ai-projects==2.0.0b1 jsonref python-dotenv
 ```
 
 
 ### Create a `.env` File  
 
-We’ll store secrets (such as your project connection string) in an environment file for security and flexibility.  
+We'll store secrets (such as your project endpoint) in an environment file for security and flexibility.  
 
 1. **Create a file named `.env` in the root of your project directory.**
 
-2. **Add the following line to the file:**
+2. **Add the following lines to the file:**
 
     ```env
-    PROJECT_CONNECTION_STRING="https://<your-foundry-resource>.services.ai.azure.com/api/projects/<your-project-name>"
+    PROJECT_ENDPOINT="https://<your-foundry-resource>.services.ai.azure.com/api/projects/<your-project-name>"
+    MODEL_DEPLOYMENT_NAME="gpt-4o"
     ```
 
 Replace `https://<your-foundry-resource>.services.ai.azure.com/api/projects/<your-project-name>` with the actual values from your Microsoft Foundry project. 
 
 ![](/public/foundry/foundry-project-string.png)  
 
 
-3. **Where to find your connection string:**
+3. **Where to find your endpoint:**
 
    - Go to the **Microsoft Foundry portal**
    - Navigate to your project
    - Click on **Overview**
-   - The connection string will be displayed on the homepage of your project
+   - The endpoint will be displayed on the homepage of your project
 
 
 
@@ -65,7 +62,7 @@ Replace `https://<your-foundry-resource>.services.ai.azure.com/api/projects/<you
 
 ## Create a Basic Agent  
 
-We’ll now create a basic Python script that defines and runs an agent.  
+We'll now create a basic Python script that defines and runs an agent.  
 
 - Start by creating a new file called: **`agent.py`** in the **workshop** folder
 
@@ -77,126 +74,89 @@ These imports bring in the Azure SDK, environment handling, and helper classes:
 
 ```python
 import os
-from azure.ai.projects import AIProjectClient
-from azure.identity import DefaultAzureCredential
-from azure.ai.agents.models import MessageRole, FilePurpose, FunctionTool, FileSearchTool, ToolSet
 from dotenv import load_dotenv
+from azure.identity import DefaultAzureCredential
+from azure.ai.projects import AIProjectClient
+from azure.ai.projects.models import PromptAgentDefinition
 ```
 
 ### Load the `.env` File  
 
 Load environment variables into your script by adding this line to `agent.py`:  
 
 ```python
-load_dotenv(override=True)
+load_dotenv()
 ```
 
 
 
-### Create an `AIProjectClient` Instance  
+### Create the Project Client  
 
-This client connects your script to the Microsoft Foundry service using the connection string and your Azure credentials.  
+This client connects your script to the Microsoft Foundry service using the endpoint and your Azure credentials.  
 
 ```python
 project_client = AIProjectClient(
-    endpoint=os.environ["PROJECT_CONNECTION_STRING"],
-    credential=DefaultAzureCredential()
+    endpoint=os.environ["PROJECT_ENDPOINT"],
+    credential=DefaultAzureCredential(),
 )
+openai_client = project_client.get_openai_client()
 ```
 
 
 
 ### Create the Agent  
 
-Now, let’s create the agent itself. In this case, it will use the **GPT-4o** model.  
+Now, let's create the agent itself. We'll use `create_version` to create a Foundry Agent with a `PromptAgentDefinition`.  
 
 ```python
-agent = project_client.agents.create_agent(
-    model="gpt-4o",
-    name="my-agent"
+agent = project_client.agents.create_version(
+    agent_name="hello-world-agent",
+    definition=PromptAgentDefinition(
+        model=os.environ["MODEL_DEPLOYMENT_NAME"],
+    ),
 )
-print(f"Created agent, ID: {agent.id}")
+print(f"Agent created (id: {agent.id}, name: {agent.name}, version: {agent.version})")
 ```
 
 
 
-### Create a Thread  
+### Create a Conversation  
 
-Agents interact within threads. A thread is like a conversation container that stores all messages exchanged between the user and the agent.  
+Agents interact within conversations. A conversation is like a container that stores all messages exchanged between the user and the agent.  
 
 ```python
-thread = project_client.agents.threads.create()
-print(f"Created thread, ID: {thread.id}")
+conversation = openai_client.conversations.create()
+print(f"Created conversation (id: {conversation.id})")
 ```
 
 
 
-### Add a Message  
+### Chat with the Agent  
 
-This loop lets you send messages to the agent. Type into the terminal, and the message will be added to the thread.  
+This loop lets you send messages to the agent. Type into the terminal, and the message will be sent to the agent.  
 
 ```python
-try:
-    while True:
-
-        # Get the user input
-        user_input = input("You: ")
-
-        # Break out of the loop
-        if user_input.lower() in ["exit", "quit"]:
-            break
-
-        # Add a message to the thread
-        message = project_client.agents.messages.create(
-            thread_id=thread.id,
-            role=MessageRole.USER, 
-            content=user_input
+while True:
+    # Get the user input
+    user_input = input("You: ")
+
+    if user_input.lower() in ["exit", "quit"]:
+        print("Exiting the chat.")
+        break
+
+    # Get the agent response
+    response = openai_client.responses.create(
+        conversation=conversation.id,
+        input=user_input,
+        extra_body={"agent": {"name": agent.name, "type": "agent_reference"}},
     )
-```
 
-
-
-### Create and Process an Agent Run  
-
-The agent processes the conversation thread and generates a response.  
-
-```python
-        run = project_client.agents.runs.create_and_process(
-            thread_id=thread.id, 
-            agent_id=agent.id
-        )
+    # Print the agent response
+    print(f"Assistant: {response.output_text}")
 ```
 
 
 
-### Fetch All Messages from the Thread  
-
-This retrieves all messages from the thread and prints the agent’s most recent response.  
-
-```python
-        messages = project_client.agents.messages.list(thread_id=thread.id)
-        first_message = next(iter(messages), None) 
-        if first_message: 
-            print(next((item["text"]["value"] for item in first_message.content if item.get("type") == "text"), "")) 
-```
-
-
-
-### Delete the Agent When Done  
-
-Once you’re finished, clean up by deleting the agent:  
-
-```python
-finally:
-    # Clean up the agent when done
-    project_client.agents.delete_agent(agent.id)
-    print("Deleted agent")
-```
-
-Add this code to delete the agent outside of the while True-loop. Otherwise the agent will be deleted immediately after your first interaction.
-
-
-
 ## Run the Agent  
 
 Finally, run the Python script:  
@@ -211,17 +171,17 @@ You can now chat with your agent directly in the terminal. Type `exit` or `quit`
 
 If you get an error (the principal `*****-****-***-****-*****`) does **not have permission** to create assistants in your Microsoft Foundry project. Specifically, it's missing the **`Microsoft.CognitiveServices/accounts/AIServices/agents/write`** data action.
 
-Here’s how to fix it:
+Here's how to fix it:
 
 1. **Go to the Azure Portal**: [https://portal.azure.com](https://portal.azure.com)
 
 2. **Navigate to your Microsoft Foundry resource**:
    - You can find it by searching for the name of your Foundry resource (e.g., `my-foundry-name`).
 
-3. **Open the “Access Control (IAM)” panel**:
+3. **Open the "Access Control (IAM)" panel**:
    - In the left-hand menu of the resource, click **Access Control (IAM)**.
 
-4. **Click “Add role assignment”**:
+4. **Click "Add role assignment"**:
    - Choose **Add → Add role assignment**
    - Select a role that includes the required data action:
      - Recommended: **Cognitive Services Contributor** or a **custom role** that includes `Microsoft.CognitiveServices/accounts/AIServices/agents/write`
@@ -241,15 +201,14 @@ Here’s how to fix it:
 In this chapter, you have:  
 
 - Logged in to Azure  
-- Retrieved a connection string  
+- Retrieved a project endpoint  
 - Separated secrets from code using `.env`  
-- Created a basic agent with the Microsoft Foundry Agent Service  
-- Started a conversation with a **GPT-4o** model  
-- Cleaned up by deleting the agent when done  
+- Created a basic agent with the Foundry Agent Service  
+- Started a conversation with the agent  
 
 
 ## Final code sample
 
 ```python 
 <!--@include: ./codesamples/agent_2.py-->
-```
+```