address review comments

Author: jsimonweb

example-apps/agent-builder-a2a-agent-framework/Dockerfile

@@ -0,0 +1,15 @@
+FROM python:3.11-slim
+
+WORKDIR /app
+
+RUN python -m venv /opt/venv
+
+ENV PATH="/opt/venv/bin:$PATH"
+
+COPY requirements.txt .
+
+RUN pip install -r requirements.txt
+
+COPY elastic_agent_builder_a2a.py .
+
+CMD ["python", "elastic_agent_builder_a2a.py"]

example-apps/agent-builder-a2a-agent-framework/docker-compose.yml

@@ -8,7 +8,7 @@ This is an example Python console app that demonstrates how to connect and utili
 
 1. An Elasticsearch deployment running in [Elastic Cloud](https://cloud.elastic.co/registration?utm_source=github&utm_content=elasticsearch-labs-example-apps). 
    * Requires Elasticsearch Serverless (or for hosted deployments at least Elasticsearch version 9.2.0).
-2. An integrated development environment (IDE)  like [Visual Studio Code](https://code.visualstudio.com/download) running on your local computer.  
+2. A text editor or an integrated development environment (IDE) like [Visual Studio Code](https://code.visualstudio.com/download) running on your local computer.  
 3. [Python version 3.10 or greater](https://www.python.org/downloads/) installed on your local computer.
 
 ## Setup your Elasticsearch deployment
@@ -72,41 +72,44 @@ This is an example Python console app that demonstrates how to connect and utili
 
 
 
-## Running the example app
+## Clone the example app
 
-1. Open Visual Studio Code and open a new terminal within the Visual Studio Code editor. 
-2. In the open terminal, clone the Search Labs source code repository which contains the Elastic Agent Builder A2A App example.
+1. Open a terminal and clone the Search Labs source code repository which contains the Elastic Agent Builder A2A App example. Run the following command to clone the example app:
 
         git clone https://github.com/elastic/elasticsearch-labs
 
-3.  `cd` to change directory to the example code located in the `example-apps/agent-builder-a2a-agent-framework` subdirectory.
+3.  `cd` to change directory to the example code located in the `supporting-blog-content/agent-builder-a2a-agent-framework` subdirectory.
 
-        cd elasticsearch-labs/example-apps/agent-builder-a2a-agent-framework
+        cd elasticsearch-labs/supporting-blog-content/agent-builder-a2a-agent-framework
 
-4. Replace placeholder values in `elastic_agent_builder_a2a.py` with values copied from your Elastic deployment.   
-   1. Open the file `elastic_agent_builder_a2a.py` in the Visual Studio editor.  
-   2. Replace <YOUR-ELASTIC-AGENT-BUILDER-URL\>  
+## Setup up the environment variables
+
+1. Setup the environment variables with values copied from your Elastic deployment. 
+   1. Make a copy of the file `env.example` and name the new file `.env ` 
+   2. Edit the `.env` file to set the values of the environment variables to use the values copied from your Elastic deployment. 
+   * Replace <YOUR-ELASTIC-AGENT-BUILDER-URL\>  
       1. In your Elastic deployment, go to the Elastic Agent Builder - Tools page. Click the **MCP Server** dropdown at the top of the Tools page. Select **Copy MCP Server URL.**   
-      2. In Visual Studio add the **MCP Server URL** value to the `elastic-agent-builder-a2a.py` file. 
+      2. Add the **MCP Server URL** value to the `.env` file. 
          * Find where the placeholder text “**<YOUR-ELASTIC-AGENT-BUILDER-URL\>**” appears and paste in the copied **MCP Server URL** to replace the placeholder text. Now edit the pasted **MCP Server URL**. Delete the text “mcp” at the end of the URL and replace it with the text “a2a”.  The edited URL should look something like this
 
             `https://example-project-a123.kb.westus2.azure.elastic.cloud/api/agent_builder/a2a`
 
-   3. Replace <YOUR-ELASTIC-API-KEY\>  
+   * Replace <YOUR-ELASTIC-API-KEY\>  
       1. In your Elastic deployment, click **Elasticsearch** in the navigation menu to go to your deployment’s home page.  
       2. Click **Create API key** to create a new API key.   
       3. After the API key is created, copy the API Key value.  
-      4. In Visual Studio add the API Key value to the `elastic-agent-builder-a2a.py` file.
+      4. Add the API Key value to the `.env` file.
          * Find where the placeholder text “**<YOUR-ELASTIC-API-KEY\>**” appears and paste in the copied API Key value to replace the placeholder text.
+ 
+   3. Save the changes to the  `.env` file.
 
-   4. Confirm the **relative_card_path** is set correctly in the `elastic-agent-builder-a2a.py` file by finding the code line that starts with the text “agent_card”. Confirm that the **relative_card_path** matches the Agent ID you specified when you created the agent in Elastic Agent Builder. If your Agent ID is “helloworld_agent” then the **relative_card_path** should be set to `/helloworld_agent.json`   
-   5. Save the `elastic_agent_builder_a2a.py` file in the Visual Studio editor.
+## Running the example app with Python
 
-5.  Create a Python virtual environment by running the following code in the Visual Studio Code terminal.
+1.  Create a Python virtual environment by running the following code in the terminal.
 
         python -m venv .venv
      
-6. Activate the Python virtual environment.  
+2. Activate the Python virtual environment.  
     * If you’re running MacOS, the command to activate the virtual environment is:
 
             source .venv/bin/activate
@@ -115,25 +118,16 @@ This is an example Python console app that demonstrates how to connect and utili
 
             .venv\Scripts\activate
 
-7. Install the Microsoft Agent Framework with the following `pip` command:
+3. Install the Microsoft Agent Framework along with its necessary Python packages by running the following `pip` command:
 
-        pip install agent-framework
+        pip install -r requirements.txt
 
-8. Run the example code by entering the following command into the terminal:
+4. Run the example app by entering the following command into the terminal:
 
         python elastic_agent_builder_a2a.py
 
-## Running the example test
-
-1. Setup the environment variables.  
-   1. Make a copy of the file `env.example` and name the new file `.env ` 
-   2. Edit the `.env` file to set the values of the environment variables to use the values copied from your Elastic deployment. See instructions on where to get these values in the [Running the example app](#running-the-example-app) section of this `README.md` file.  
-        * Set the value of **ES_AGENT_URL** to be the value of **YOUR-ELASTIC-AGENT-BUILDER-URL** 
-        * Set the value of **ES_API_KEY** to be value of **YOUR-ELASTIC-API-KEY**
-2. Run the test directly with Python.
-
-        python test_elastic_agent_builder_a2a.py
+## Running the example app with Docker
 
-3. Run the test with Docker.
+1. Run the example app with Docker by entering the following command into the terminal:
 
-        docker compose up
+        docker compose run elastic-agent-builder-a2a

example-apps/agent-builder-a2a-agent-framework/env.example

@@ -0,0 +1,9 @@
+services:
+  elastic-agent-builder-a2a:
+    build: .
+    container_name: elastic-agent-builder-a2a
+    stdin_open: true
+    tty: true
+    environment:
+      - ES_AGENT_URL=${ES_AGENT_URL}
+      - ES_API_KEY=${ES_API_KEY}

example-apps/agent-builder-a2a-agent-framework/test_elastic_agent_builder_a2a.py

@@ -1,15 +1,19 @@
 import asyncio
+from dotenv import load_dotenv
 import httpx
+import os
 from a2a.client import A2ACardResolver
 from agent_framework.a2a import A2AAgent
 
 
 async def main():
-    a2a_agent_host = "<YOUR-ELASTIC-AGENT-BUILDER-URL>"
+    load_dotenv()
+    a2a_agent_host = os.getenv("ES_AGENT_URL")
+    a2a_agent_key = os.getenv("ES_API_KEY")
 
     print(f"Connection to Elastic A2A agent at: {a2a_agent_host}")
 
-    custom_headers = {"Authorization": "ApiKey <YOUR-ELASTIC-API-KEY>"}
+    custom_headers = {"Authorization": f"ApiKey {a2a_agent_key}"}
 
     async with httpx.AsyncClient(timeout=60.0, headers=custom_headers) as http_client:
         # Resolve the A2A Agent Card

supporting-blog-content/agent-builder-a2a-agent-framework/Dockerfile

@@ -0,0 +1,2 @@
+ES_AGENT_URL=<YOUR-ELASTIC-AGENT-BUILDER-URL>
+ES_API_KEY=<YOUR-ELASTIC-API-KEY>

example-apps/agent-builder-a2a-agent-framework/README.md renamed to supporting-blog-content/agent-builder-a2a-agent-framework/README.md

@@ -0,0 +1,131 @@
+a2a-sdk~=0.3.14
+ag-ui-protocol~=0.1.10
+agent-framework~=1.0.0b251114
+agent-framework-a2a~=1.0.0b251114
+agent-framework-ag-ui~=1.0.0b251117
+agent-framework-anthropic~=1.0.0b251114
+agent-framework-azure-ai~=1.0.0b251114
+agent-framework-azurefunctions~=1.0.0b251114
+agent-framework-chatkit~=1.0.0b251114
+agent-framework-copilotstudio~=1.0.0b251114
+agent-framework-core~=1.0.0b251114
+agent-framework-devui~=1.0.0b251114
+agent-framework-lab~=1.0.0b251024
+agent-framework-mem0~=1.0.0b251114
+agent-framework-purview~=1.0.0b251114
+agent-framework-redis~=1.0.0b251114
+aiohappyeyeballs~=2.6.1
+aiohttp~=3.13.2
+aiosignal~=1.4.0
+annotated-doc~=0.0.4
+annotated-types~=0.7.0
+anthropic~=0.74.0
+anyio~=4.11.0
+attrs~=25.4.0
+azure-ai-agents~=1.2.0b5
+azure-ai-projects~=2.0.0b2
+azure-core~=1.36.0
+azure-functions~=1.24.0
+azure-functions-durable~=1.4.0
+azure-identity~=1.25.1
+azure-storage-blob~=12.27.1
+backoff~=2.2.1
+cachetools~=6.2.2
+certifi~=2025.11.12
+cffi~=2.0.0
+charset-normalizer~=3.4.4
+click~=8.3.1
+colorama~=0.4.6
+cryptography~=46.0.3
+distro~=1.9.0
+docstring_parser~=0.17.0
+fastapi~=0.121.2
+frozenlist~=1.8.0
+furl~=2.1.4
+google-api-core~=2.28.1
+google-auth~=2.43.0
+googleapis-common-protos~=1.72.0
+griffe~=1.15.0
+grpcio~=1.76.0
+h11~=0.16.0
+h2~=4.3.0
+hpack~=4.1.0
+httpcore~=1.0.9
+httptools~=0.7.1
+httpx~=0.28.1
+httpx-sse~=0.4.3
+hyperframe~=6.1.0
+idna~=3.11
+importlib_metadata~=8.7.0
+isodate~=0.7.2
+jiter~=0.12.0
+jsonpath-ng~=1.7.0
+jsonschema~=4.25.1
+jsonschema-specifications~=2025.9.1
+MarkupSafe~=3.0.3
+mcp~=1.21.2
+mem0ai~=1.0.1
+microsoft-agents-activity~=0.6.0
+microsoft-agents-copilotstudio-client~=0.6.0
+microsoft-agents-hosting-core~=0.6.0
+ml_dtypes~=0.5.4
+msal~=1.34.0
+msal-extensions~=1.3.1
+multidict~=6.7.0
+numpy~=2.3.5
+openai~=2.8.1
+openai-agents~=0.6.0
+openai-chatkit~=1.3.0
+opentelemetry-api~=1.38.0
+opentelemetry-exporter-otlp-proto-common~=1.38.0
+opentelemetry-exporter-otlp-proto-grpc~=1.38.0
+opentelemetry-proto~=1.38.0
+opentelemetry-sdk~=1.38.0
+opentelemetry-semantic-conventions~=0.59b0
+opentelemetry-semantic-conventions-ai~=0.4.13
+orderedmultidict~=1.0.2
+packaging~=25.0
+ply~=3.11
+portalocker~=3.2.0
+posthog~=7.0.1
+propcache~=0.4.1
+proto-plus~=1.26.1
+protobuf~=5.29.5
+pyasn1~=0.6.1
+pyasn1_modules~=0.4.2
+pycparser~=2.23
+pydantic~=2.12.4
+pydantic-settings~=2.12.0
+pydantic_core~=2.41.5
+PyJWT~=2.10.1
+python-dateutil~=2.9.0.post0
+python-dotenv~=1.2.1
+python-multipart~=0.0.20
+python-ulid~=3.1.0
+pytz~=2025.2
+PyYAML~=6.0.3
+qdrant-client~=1.16.0
+redis~=6.4.0
+redisvl~=0.11.0
+referencing~=0.37.0
+requests~=2.32.5
+rpds-py~=0.29.0
+rsa~=4.9.1
+six~=1.17.0
+sniffio~=1.3.1
+SQLAlchemy~=2.0.44
+sse-starlette~=3.0.3
+starlette~=0.49.3
+tenacity~=9.1.2
+tqdm~=4.67.1
+types-requests~=2.32.4.20250913
+typing-inspection~=0.4.2
+typing_extensions~=4.15.0
+urllib3~=2.5.0
+uvicorn~=0.38.0
+uvloop~=0.22.1
+watchfiles~=1.1.1
+websockets~=15.0.1
+Werkzeug~=3.1.3
+yarl~=1.22.0
+zipp~=3.23.0