update

Author: mattgotteiner

agent-example/agent-example.ipynb

@@ -79,7 +79,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 9,
+   "execution_count": 1,
    "id": "e42b4a10",
    "metadata": {},
    "outputs": [],
@@ -118,7 +118,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 10,
+   "execution_count": 2,
    "id": "91fd6810",
    "metadata": {},
    "outputs": [
@@ -188,7 +188,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 11,
+   "execution_count": 3,
    "id": "f98f31e7",
    "metadata": {},
    "outputs": [
@@ -225,7 +225,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 12,
+   "execution_count": 4,
    "id": "fbe31e32",
    "metadata": {},
    "outputs": [
@@ -281,24 +281,23 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 13,
+   "execution_count": null,
    "id": "6eb0ebd3",
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "{'object': 'list', 'data': [{'id': 'asst_lzafrxILzTmhdFaMMEVjuhE8', 'object': 'assistant', 'created_at': 1746940688, 'name': 'earth-search-agent', 'description': None, 'model': 'gpt-4o-mini', 'instructions': '\\nAn Q&A agent that can answer questions about the Earth at night.\\nSources have a JSON format with a ref_id that must be cited in the answer.\\nIf you do not have the answer, respond with \"I don\\'t know\".\\n', 'tools': [], 'top_p': 1.0, 'temperature': 1.0, 'tool_resources': {}, 'metadata': {}, 'response_format': 'auto'}], 'first_id': 'asst_lzafrxILzTmhdFaMMEVjuhE8', 'last_id': 'asst_lzafrxILzTmhdFaMMEVjuhE8', 'has_more': False}"
+       "{'object': 'list', 'data': [{'id': 'asst_sXngVG4fzu0bQJNFmTxzX6h4', 'object': 'assistant', 'created_at': 1746940725, 'name': 'earth-search-agent', 'description': None, 'model': 'gpt-4o-mini', 'instructions': '\\nAn Q&A agent that can answer questions about the Earth at night.\\nSources have a JSON format with a ref_id that must be cited in the answer.\\nIf you do not have the answer, respond with \"I don\\'t know\".\\n', 'tools': [], 'top_p': 1.0, 'temperature': 1.0, 'tool_resources': {}, 'metadata': {}, 'response_format': 'auto'}, {'id': 'asst_lzafrxILzTmhdFaMMEVjuhE8', 'object': 'assistant', 'created_at': 1746940688, 'name': 'earth-search-agent', 'description': None, 'model': 'gpt-4o-mini', 'instructions': '\\nAn Q&A agent that can answer questions about the Earth at night.\\nSources have a JSON format with a ref_id that must be cited in the answer.\\nIf you do not have the answer, respond with \"I don\\'t know\".\\n', 'tools': [], 'top_p': 1.0, 'temperature': 1.0, 'tool_resources': {}, 'metadata': {}, 'response_format': 'auto'}], 'first_id': 'asst_sXngVG4fzu0bQJNFmTxzX6h4', 'last_id': 'asst_lzafrxILzTmhdFaMMEVjuhE8', 'has_more': False}"
       ]
      },
-     "execution_count": 13,
+     "execution_count": 5,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
     "from azure.ai.projects import AIProjectClient\n",
-    "import json\n",
     "\n",
     "project_client = AIProjectClient.from_connection_string(project_conn_str, credential=credential)\n",
     "\n",
@@ -307,7 +306,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 14,
+   "execution_count": null,
    "id": "aa363122",
    "metadata": {},
    "outputs": [
@@ -326,7 +325,7 @@
     "project_client = AIProjectClient.from_connection_string(project_conn_str, credential=credential)\n",
     "\n",
     "instructions = \"\"\"\n",
-    "An Q&A agent that can answer questions about the Earth at night.\n",
+    "A Q&A agent that can answer questions about the Earth at night.\n",
     "Sources have a JSON format with a ref_id that must be cited in the answer.\n",
     "If you do not have the answer, respond with \"I don't know\".\n",
     "\"\"\"\n",
@@ -351,7 +350,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 15,
+   "execution_count": 7,
    "id": "de2ee775",
    "metadata": {},
    "outputs": [],
@@ -378,7 +377,7 @@
     "    messages.data.reverse()\n",
     "    retrieval_result = agent_client.knowledge_retrieval.retrieve(\n",
     "        retrieval_request=KnowledgeAgentRetrievalRequest(\n",
-    "            messages=[KnowledgeAgentMessage(role=msg[\"role\"], content=[KnowledgeAgentMessageTextContent(text=msg.content[0].text)]) for msg in messages.data],\n",
+    "            messages=[KnowledgeAgentMessage(role=msg[\"role\"], content=[KnowledgeAgentMessageTextContent(text=msg.content[0].text)]) for msg in messages.data if msg[\"role\"] != \"system\"],\n",
     "            target_index_params=[KnowledgeAgentIndexParams(index_name=index_name, reranker_threshold=2.5)]\n",
     "        )\n",
     "    )\n",
@@ -412,24 +411,29 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 16,
+   "execution_count": 8,
    "id": "f1fc04fc",
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Agent response: Suburban areas display larger December brightening than urban cores primarily due to the distribution of light sources and land use patterns\n",
-      " While urban cores may have higher absolute light levels, the suburban belt tends to have more residential areas, which are often illuminated during the darker winter months\n",
-      " These suburbs typically have street lights, homes, and other light sources that contribute to the overall brightness in the vicinity\n",
-      " In contrast, urban cores may have more concentrated lighting in commercial areas that are not uniformly distributed, making the suburban regions appear more luminous during certain times, especially in winter months when daylight is limited (ref_id: 0)\n",
+      "Agent response: The differences in nighttime brightness between suburban belts and urban cores can be attributed to several factors:\n",
+      "\n",
+      "1\n",
+      " **December Brightening**: Suburban areas tend to have a greater relative increase in brightness during December due to seasonal decorations, festive lighting, and residential activity\n",
+      " In contrast, urban cores may have higher absolute light levels due to commercial lighting, but the types of light and their arrangement can lead to a less pronounced increase compared to the festive displays in suburban settings\n",
+      " Urban centers often focus on commercial light sources that may not display the same wide variability in illumination as residential areas do during holidays (Source: ref_id 0)\n",
+      "\n",
+      "\n",
+      "2\n",
+      " **Visibility of Phoenix's Nighttime Grid**: The sharp visibility of the Phoenix nighttime street grid from space can be attributed to its planned urban layout, which features a grid pattern of streets and blocks that are well-illuminated\n",
+      " This grid is a result of urban design that promotes easy navigation and access, leading to concentrated bright spots along major streets and intersections\n",
+      " In contrast, the interstate stretches in the Midwest tend to connect larger rural areas with fewer lighted nodes due to the sparser population and fewer urban developments, making those areas appear relatively dim from space (Source: ref_id 1)\n",
       "\n",
       "\n",
-      "As for Phoenix, the sharp visibility of its nighttime street grid from space can be attributed to its organized urban layout and the prevalence of street lighting along major transportation corridors\n",
-      " The city is laid out in a regular grid pattern with a focus on facilitating traffic flow, leading to bright illumination along these streets\n",
-      " This contrasts with large stretches of interstate highways between Midwestern cities, where the rural nature and lower population density result in significantly less light\n",
-      " In these areas, fewer urban centers and residential developments lead to darker patches, making them less visible from space compared to densely lit urban areas like Phoenix (ref_id: 1)\n",
+      "The differences in light patterns between urban and suburban areas, alongside the planned layouts of cities like Phoenix, significantly influence how they are perceived in nighttime satellite imagery\n",
       "\n"
      ]
     }
@@ -464,7 +468,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 17,
+   "execution_count": 9,
    "id": "7b90fefa",
    "metadata": {},
    "outputs": [
@@ -478,7 +482,7 @@
       "    \"id\": 0,\n",
       "    \"type\": \"ModelQueryPlanning\",\n",
       "    \"input_tokens\": 1265,\n",
-      "    \"output_tokens\": 271\n",
+      "    \"output_tokens\": 277\n",
       "  },\n",
       "  {\n",
       "    \"id\": 1,\n",
@@ -487,9 +491,9 @@
       "    \"query\": {\n",
       "      \"search\": \"suburban belts December brightening urban cores comparison\"\n",
       "    },\n",
-      "    \"query_time\": \"2025-05-11T05:19:00.563Z\",\n",
+      "    \"query_time\": \"2025-05-13T22:22:45.368Z\",\n",
       "    \"count\": 0,\n",
-      "    \"elapsed_ms\": 354\n",
+      "    \"elapsed_ms\": 350\n",
       "  },\n",
       "  {\n",
       "    \"id\": 2,\n",
@@ -498,9 +502,9 @@
       "    \"query\": {\n",
       "      \"search\": \"Phoenix nighttime street grid visibility from space\"\n",
       "    },\n",
-      "    \"query_time\": \"2025-05-11T05:19:00.890Z\",\n",
+      "    \"query_time\": \"2025-05-13T22:22:45.682Z\",\n",
       "    \"count\": 2,\n",
-      "    \"elapsed_ms\": 314\n",
+      "    \"elapsed_ms\": 304\n",
       "  },\n",
       "  {\n",
       "    \"id\": 3,\n",
@@ -509,14 +513,14 @@
       "    \"query\": {\n",
       "      \"search\": \"interstate visibility from space midwestern cities\"\n",
       "    },\n",
-      "    \"query_time\": \"2025-05-11T05:19:01.133Z\",\n",
+      "    \"query_time\": \"2025-05-13T22:22:45.977Z\",\n",
       "    \"count\": 2,\n",
-      "    \"elapsed_ms\": 241\n",
+      "    \"elapsed_ms\": 291\n",
       "  },\n",
       "  {\n",
       "    \"id\": 4,\n",
       "    \"type\": \"AzureSearchSemanticRanker\",\n",
-      "    \"input_tokens\": 74735\n",
+      "    \"input_tokens\": 74224\n",
       "  }\n",
       "]\n",
       "Retrieval results\n",
@@ -571,39 +575,40 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 18,
+   "execution_count": 10,
    "id": "d9478191",
    "metadata": {},
    "outputs": [
     {
      "name": "stdout",
      "output_type": "stream",
      "text": [
-      "Agent response: To find lava at night, you can utilize the distinct glow produced by active lava flows, which can often be visible from considerable distances, especially under sufficient moonlight\n",
-      " Here are some ways to spot lava at night:\n",
+      "Agent response: To find lava at night, you can take advantage of various natural and technological methods:\n",
       "\n",
       "1\n",
-      " **Use Satellite Imagery**: Advanced satellites equipped with thermal imaging can detect the heat emitted from lava flows\n",
-      " For instance, data from the VIIRS Day/Night Band on polar-orbiting satellites can capture glowing lava, even when the only illumination is moonlight\n",
-      " Observers looking from space can distinguish the warm glow from lava flows against the cooler landscape\n",
+      " **Natural Glow**: Active lava flows produce a significant glow, which can be visible from a distance at night\n",
+      " Under good visibility conditions, the bright red-orange light of flowing lava can be seen against the darker landscape\n",
+      " Observing this from higher vantage points or from areas with minimal light pollution can enhance visibility\n",
       "\n",
       "\n",
       "2\n",
-      " **Location of Volcanoes**: Focus on areas known for volcanic activity, such as Mount Etna in Italy or Kilauea in Hawaii\n",
-      " For example, the eruption of Mount Etna has been photographed at night, showing the bright red and orange hues of flowing lava as a contrast to the surrounding darkness (ref_id: 1)\n",
-      " \n",
+      " **Satellite Imagery**: During nighttime, satellites equipped with capabilities like the VIIRS (Visible Infrared Imaging Radiometer Suite) can capture images of areas with volcanic activity\n",
+      " These images show the glow of active lava flows clearly against the background, which highlights volcanic eruptions and their effects\n",
+      " For example, images of Mount Etna and Kilauea have shown their lava flows brightly illuminated at night (Source: ref_id 1, ref_id 4)\n",
+      "\n",
       "\n",
       "3\n",
-      " **Monitoring for Eruptions**: Stay informed about active volcanoes through geological surveys, which often provide real-time updates on volcanic activity\n",
-      " During eruptions, lava will glow brightly, making it easier to identify at night\n",
+      " **Infrared Imaging**: Thermal imaging can also assist in identifying hot lava spots\n",
+      " This method utilizes infrared sensors to detect heat emitted by lava flows, making it effective even in darkness\n",
+      " Satellites and drones equipped with thermal cameras can provide detailed imagery showing lava flows and their progression\n",
       "\n",
       "\n",
       "4\n",
-      " **Natural Light Sources**: Look for lava flows under optimum conditions, such as on nights with a full moon, when the light can enhance visibility\n",
-      " At night, the unique glow from lava can serve as a key indicator of eruptive activity, as it stands out starkly against the dark surroundings (ref_id: 0)\n",
+      " **Safety Considerations**: While observing lava, always prioritize safety\n",
+      " Ensure you are at a safe distance from volcanic activity and follow any guidance from local authorities regarding volcanic eruptions\n",
       "\n",
       "\n",
-      "By leveraging these observations and resources, you should be able to locate lava at night effectively\n",
+      "In summary, you can find lava at night by looking for its natural glow, using satellite imagery and infrared sensors, and ensuring a safe viewing approach\n",
       "\n"
      ]
     }
@@ -633,7 +638,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 19,
+   "execution_count": 11,
    "id": "c063c45e",
    "metadata": {},
    "outputs": [
@@ -646,8 +651,8 @@
       "  {\n",
       "    \"id\": 0,\n",
       "    \"type\": \"ModelQueryPlanning\",\n",
-      "    \"input_tokens\": 1532,\n",
-      "    \"output_tokens\": 323\n",
+      "    \"input_tokens\": 1565,\n",
+      "    \"output_tokens\": 299\n",
       "  },\n",
       "  {\n",
       "    \"id\": 1,\n",
@@ -656,36 +661,36 @@
       "    \"query\": {\n",
       "      \"search\": \"how to locate lava flows at night\"\n",
       "    },\n",
-      "    \"query_time\": \"2025-05-11T05:19:16.473Z\",\n",
+      "    \"query_time\": \"2025-05-13T22:23:07.269Z\",\n",
       "    \"count\": 6,\n",
-      "    \"elapsed_ms\": 528\n",
+      "    \"elapsed_ms\": 376\n",
       "  },\n",
       "  {\n",
       "    \"id\": 2,\n",
       "    \"type\": \"AzureSearchQuery\",\n",
       "    \"target_index\": \"earth_at_night\",\n",
       "    \"query\": {\n",
-      "      \"search\": \"best tools for finding lava at night\"\n",
+      "      \"search\": \"best tools for viewing lava at night\"\n",
       "    },\n",
-      "    \"query_time\": \"2025-05-11T05:19:16.766Z\",\n",
-      "    \"count\": 0,\n",
-      "    \"elapsed_ms\": 281\n",
+      "    \"query_time\": \"2025-05-13T22:23:07.575Z\",\n",
+      "    \"count\": 1,\n",
+      "    \"elapsed_ms\": 293\n",
       "  },\n",
       "  {\n",
       "    \"id\": 3,\n",
       "    \"type\": \"AzureSearchQuery\",\n",
       "    \"target_index\": \"earth_at_night\",\n",
       "    \"query\": {\n",
-      "      \"search\": \"safety tips for finding lava at night\"\n",
+      "      \"search\": \"safety tips for exploring lava at night\"\n",
       "    },\n",
-      "    \"query_time\": \"2025-05-11T05:19:17.037Z\",\n",
+      "    \"query_time\": \"2025-05-13T22:23:07.857Z\",\n",
       "    \"count\": 0,\n",
-      "    \"elapsed_ms\": 269\n",
+      "    \"elapsed_ms\": 281\n",
       "  },\n",
       "  {\n",
       "    \"id\": 4,\n",
       "    \"type\": \"AzureSearchSemanticRanker\",\n",
-      "    \"input_tokens\": 71937\n",
+      "    \"input_tokens\": 70920\n",
       "  }\n",
       "]\n",
       "Retrieval results\n",
@@ -761,7 +766,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 23,
+   "execution_count": 12,
    "id": "d67f8609",
    "metadata": {},
    "outputs": [
@@ -789,7 +794,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 24,
+   "execution_count": 13,
    "id": "d9895f27",
    "metadata": {},
    "outputs": [