## Python SDK Changes:

* `glean.client.insights.retrieve()`:  `response.agents_response.top_use_cases_insights` **Added**

Author: speakeasybot

.speakeasy/gen.lock

@@ -1,19 +1,19 @@
 lockVersion: 2.0.0
 id: 3e3290ca-0ee8-4981-b1bc-14536048fa63
 management:
-  docChecksum: d8e27f2118bb2e9b6f10f3c87ad1abab
+  docChecksum: 258599659a645cf36629cb927fbf3e8f
   docVersion: 0.9.0
-  speakeasyVersion: 1.761.8
-  generationVersion: 2.881.2
-  releaseVersion: 0.12.24
-  configChecksum: 9cfd2ffe12f50ecc2330ef075db81617
+  speakeasyVersion: 1.761.9
+  generationVersion: 2.881.4
+  releaseVersion: 0.12.25
+  configChecksum: 2581bd242339b45d5ca64ca15a7fa62e
   repoURL: https://github.com/gleanwork/api-client-python.git
   installationURL: https://github.com/gleanwork/api-client-python.git
   published: true
 persistentEdits:
-  generation_id: ff1736a9-02f4-498c-ae0b-15f0a711a541
-  pristine_commit_hash: 4369083872c3540a60d7faaf8d98778dce4951b4
-  pristine_tree_hash: 7523ad87f407ff98c86ad1947fed200fc8278076
+  generation_id: 9fa588c2-4bc5-429c-8fce-0b821242c79a
+  pristine_commit_hash: 0207969a9391f4bb5c16f0faa1a3f059cb25eb99
+  pristine_tree_hash: 37a0055834cf7700b05ca4c44cc0d44f4711e24e
 features:
   python:
     additionalDependencies: 1.0.0
@@ -183,8 +183,8 @@ trackedFiles:
     pristine_git_object: fc4a769fd5f7f8c5e36e1eec936d9454f0f01242
   docs/models/agentsinsightsv2response.md:
     id: c419d6511b8b
-    last_write_checksum: sha1:d49bd06daf5f273c6eebe93704178fd528d7cbb2
-    pristine_git_object: dba88e1e980221c133143d71febe10860c6d6a11
+    last_write_checksum: sha1:6316c32d8ed8ff89ef8c300d04c8f7c829211bb7
+    pristine_git_object: 6400e356b5f8271904764a20ff21451b49262e26
   docs/models/agentstimesavedinsight.md:
     id: c998db614c46
     last_write_checksum: sha1:0653ac44dfc9ed51985aec9a129941b91501812a
@@ -193,6 +193,10 @@ trackedFiles:
     id: 8e00b4ec28db
     last_write_checksum: sha1:ba6bc3369d70a9f8b0cd136e5ffa9318b54222d3
     pristine_git_object: 4c36908d52176a2a907c75baa72220dd0c5b4af7
+  docs/models/agentusecaseinsight.md:
+    id: 64232b208d9b
+    last_write_checksum: sha1:1b16c2e2fb1dfe9497529830dc32cd5cf746737b
+    pristine_git_object: 88a6bd23f65b896d244ac106cada2c2bf48be582
   docs/models/agentusersinsight.md:
     id: d175e9ef2267
     last_write_checksum: sha1:13186b89e562d1930304e5f822f47de768855397
@@ -2787,8 +2791,8 @@ trackedFiles:
     pristine_git_object: e2fda7fe263c2a111e53872e3ad5bc324b4dccfe
   pyproject.toml:
     id: 5d07e7d72637
-    last_write_checksum: sha1:1476c3b7e14a27c26723cc7f3a476a4cbc766cc5
-    pristine_git_object: 5f4520c8ae37f1be6e3b00f0fd53092c6f55a24e
+    last_write_checksum: sha1:3484dad371d5e392c56d2767bb721ebd64ac6f06
+    pristine_git_object: 8bba69820ba731e758565e28b726343156348561
   scripts/prepare_readme.py:
     id: e0c5957a6035
     last_write_checksum: sha1:c2c83f71dea61eb50c9e05da83b16d18b4da8794
@@ -2815,8 +2819,8 @@ trackedFiles:
     pristine_git_object: 58c4d70ac1797b86ff5c4237cafbc344c42d8f64
   src/glean/api_client/_version.py:
     id: 0ce22b26136b
-    last_write_checksum: sha1:0538e65f8fdd1206a7d8eaa1e9cef772202c7596
-    pristine_git_object: f74aefe7e9cba3d88bfc95df27bbf172f41f3346
+    last_write_checksum: sha1:e95544294fc7be86f2f6ea545d8c00a3c5db9837
+    pristine_git_object: 07b9a3d3751d50812e7ad4f5753613421a029763
   src/glean/api_client/agents.py:
     id: b925701a9217
     last_write_checksum: sha1:e9608819a04566ba6e711f8f7cc9527d5dd095c9
@@ -2967,8 +2971,8 @@ trackedFiles:
     pristine_git_object: fd580d9a1b7770b488fc424b5f8735d8b9bf681e
   src/glean/api_client/models/__init__.py:
     id: d5f6ea5efcbe
-    last_write_checksum: sha1:1639cfb1dfa4c246c39ee46c77863c719496dbdd
-    pristine_git_object: 1a54febc4288800bfdbb82e1afdbe73a08a088a5
+    last_write_checksum: sha1:a7538e25a121cc4fb433396c9e3fa44f7eb7bd1e
+    pristine_git_object: d5e531ce13dfbab201f0b3507f9202d3431cba44
   src/glean/api_client/models/actionsummary.py:
     id: 34ccdf9f1526
     last_write_checksum: sha1:cfefc6678a5612dc8d50f2b0074dc54bb88e00e0
@@ -3047,8 +3051,8 @@ trackedFiles:
     pristine_git_object: 027fbade0c78c6974ff596ccf77a0149eeb7084b
   src/glean/api_client/models/agentsinsightsv2response.py:
     id: 2bb9ea2bc70e
-    last_write_checksum: sha1:9e985d3fa4e1bb005978c06ac7ce6d4e1801c35f
-    pristine_git_object: cf04728a8f53f60e72d88d6c9cb7396ba3c04ecb
+    last_write_checksum: sha1:9084fdd36b0b56615af5e975f0f93e51a1e745cd
+    pristine_git_object: 571897b07c8f3b0fda536dd3f05efea1a898c808
   src/glean/api_client/models/agentstimesavedinsight.py:
     id: a0f77b3b907e
     last_write_checksum: sha1:ade060149f91b527306789ab799f7aa5174416f5
@@ -3057,6 +3061,10 @@ trackedFiles:
     id: 50317bf09cb6
     last_write_checksum: sha1:6ee545d0cdd6246b7b743870984e71276ab7dfd6
     pristine_git_object: bcfd9c3071b5b45fcc0e64f404eb8e8f83e51cbe
+  src/glean/api_client/models/agentusecaseinsight.py:
+    id: 80df217107c6
+    last_write_checksum: sha1:3885677fc8a2c8ca926e9186337a3265d0d99afc
+    pristine_git_object: 4841a4ed05f1d52a81306cec477439e716591ca8
   src/glean/api_client/models/agentusersinsight.py:
     id: f40366a65563
     last_write_checksum: sha1:8190b560df9c90f0728f4d752c68eea4c1834399
@@ -5384,11 +5392,13 @@ trackedFiles:
   tests/mockserver/internal/sdk/models/components/agentsinsightsv2request.go:
     last_write_checksum: sha1:5bbebc8109a68e2b22dc0ca044b009a4ff491d1f
   tests/mockserver/internal/sdk/models/components/agentsinsightsv2response.go:
-    last_write_checksum: sha1:37dfa579c66588425502ca91ae07cb9529bebd65
+    last_write_checksum: sha1:418f4d25a0a75bf92ce5599506dafff86660c08e
   tests/mockserver/internal/sdk/models/components/agentstimesavedinsight.go:
     last_write_checksum: sha1:1c07a7a8e8de690de25bddba511878bc5d40a515
   tests/mockserver/internal/sdk/models/components/agentsusagebydepartmentinsight.go:
     last_write_checksum: sha1:21c46d3f5363b157c2e4ee70451c7d0b3e8d77df
+  tests/mockserver/internal/sdk/models/components/agentusecaseinsight.go:
+    last_write_checksum: sha1:e7d3ef7ff9b2b85433c788603548074ca5d6233a
   tests/mockserver/internal/sdk/models/components/agentusersinsight.go:
     last_write_checksum: sha1:2f737cbf66693fdffffc4d9f30a3f26b09d35eb6
   tests/mockserver/internal/sdk/models/components/allowlistoptions.go:
@@ -6601,8 +6611,8 @@ trackedFiles:
     pristine_git_object: 6cc8aeec3c52329d389081db0a27f10f53f214b9
   tests/test_messages.py:
     id: be23089b1f8b
-    last_write_checksum: sha1:bef200db8e7fff0aa33ef17846f5054a2d035a88
-    pristine_git_object: 36643db35a2d2a3cf9d327379ee7a6cb30da51d0
+    last_write_checksum: sha1:2404e23964ef6a1f5ddc900402b34e597d2d9617
+    pristine_git_object: 132005ec7d1e35f805b6a8c28e07e043bce22f0a
   tests/test_people.py:
     id: 37c243940039
     last_write_checksum: sha1:7c7268ffeebe48d81ed25e9b1cfc3a395abf5c1f
@@ -6625,8 +6635,8 @@ trackedFiles:
     pristine_git_object: df2944ebda36db652b2770dd1c23be83df90fc99
   tests/test_summarize.py:
     id: a255d8a6f627
-    last_write_checksum: sha1:56ebc69bb4f81505bc6d5f557eafd27f2bf6287d
-    pristine_git_object: 3f56a110361de93de6f420cfacda057683eabbc8
+    last_write_checksum: sha1:ac09a1189221f7d330d0ef0297311e19527dcf17
+    pristine_git_object: c8dd49d6b33f70890710b270df94bf2fe7f06407
   tests/test_tools.py:
     id: 70889bdf7321
     last_write_checksum: sha1:3c0c220f8975b050c322f6475e95f7af4e65b995
@@ -6944,7 +6954,7 @@ examples:
         application/json: {}
       responses:
         "200":
-          application/json: {"gleanAssist": {"activityInsights": [{"user": {"name": "George Clooney", "obfuscatedId": "abc123"}, "activity": "SEARCH"}]}, "overviewResponse": {"perUserInsights": [{"person": {"name": "George Clooney", "obfuscatedId": "abc123"}}]}, "assistantResponse": {"perUserInsights": [{"person": {"name": "George Clooney", "obfuscatedId": "abc123"}}]}, "agentsResponse": {"topAgentsInsights": [{"icon": {"color": "#343CED", "key": "person_icon", "iconType": "GLYPH", "name": "user"}}], "agentsUsageByDepartmentInsights": [{"icon": {"color": "#343CED", "key": "person_icon", "iconType": "GLYPH", "name": "user"}}], "agentUsersInsights": [{"person": {"name": "George Clooney", "obfuscatedId": "abc123"}}], "agentsTimeSavedInsights": [{"icon": {"color": "#343CED", "key": "person_icon", "iconType": "GLYPH", "name": "user"}}]}}
+          application/json: {"gleanAssist": {"activityInsights": [{"user": {"name": "George Clooney", "obfuscatedId": "abc123"}, "activity": "SEARCH"}]}, "overviewResponse": {"perUserInsights": [{"person": {"name": "George Clooney", "obfuscatedId": "abc123"}}]}, "assistantResponse": {"perUserInsights": [{"person": {"name": "George Clooney", "obfuscatedId": "abc123"}}]}, "agentsResponse": {"topAgentsInsights": [{"icon": {"color": "#343CED", "key": "person_icon", "iconType": "GLYPH", "name": "user"}}], "topUseCasesInsights": [{"topAgentIcon": {"color": "#343CED", "key": "person_icon", "iconType": "GLYPH", "name": "user"}}], "agentsUsageByDepartmentInsights": [{"icon": {"color": "#343CED", "key": "person_icon", "iconType": "GLYPH", "name": "user"}}], "agentUsersInsights": [{"person": {"name": "George Clooney", "obfuscatedId": "abc123"}}], "agentsTimeSavedInsights": [{"icon": {"color": "#343CED", "key": "person_icon", "iconType": "GLYPH", "name": "user"}}]}}
   messages:
     speakeasy-default-messages:
       requestBody:
@@ -7554,6 +7564,9 @@ generatedTests:
   checkdatasourceauth: "2026-02-19T15:48:52Z"
   getDatasourceInstanceConfiguration: "2026-03-09T18:34:29Z"
   updateDatasourceInstanceConfiguration: "2026-03-09T18:34:29Z"
+releaseNotes: |
+  ## Python SDK Changes:
+  * `glean.client.insights.retrieve()`:  `response.agents_response.top_use_cases_insights` **Added**
 generatedFiles:
   - .devcontainer/README.md
   - .devcontainer/devcontainer.json

.speakeasy/gen.yaml

@@ -34,7 +34,7 @@ generation:
     generateNewTests: true
     skipResponseBodyAssertions: true
 python:
-  version: 0.12.24
+  version: 0.12.25
   additionalDependencies:
     dev: {}
     main: {}

.speakeasy/glean-merged-spec.yaml

@@ -2,7 +2,7 @@ openapi: 3.0.0
 info:
   version: 0.9.0
   title: Glean API
-  x-source-commit-sha: 0aa266469924048ad422bf6314104f79b477e46a
+  x-source-commit-sha: 4d5c4d687648dfb8d9d5f53b20e5aeaf0fddaada
   description: |
     # Introduction
     In addition to the data sources that Glean has built-in support for, Glean also provides a REST API that enables customers to put arbitrary content in the search index. This is useful, for example, for doing permissions-aware search over content in internal tools that reside on-prem as well as for searching over applications that Glean does not currently support first class. In addition these APIs allow the customer to push organization data (people info, organization structure etc) into Glean.
@@ -22,7 +22,7 @@ info:
     These API clients provide type-safe, idiomatic interfaces for working with Glean IndexingAPIs in your language of choice.
   x-logo:
     url: https://app.glean.com/images/glean-text2.svg
-  x-open-api-commit-sha: 122e22b59935f3ed61845da28a7c607ebc115c9b
+  x-open-api-commit-sha: c763c8edae0a5d61aedd4428022bd29619b4871f
   x-speakeasy-name: 'Glean API'
 servers:
   - url: https://{instance}-be.glean.com
@@ -9286,6 +9286,33 @@ components:
         downvoteCount:
           type: integer
           description: Total number of downvotes for this agent over the specified time period.
+    AgentUseCaseInsight:
+      properties:
+        useCase:
+          type: string
+          description: Use case name
+        runCount:
+          type: integer
+          description: Total number of runs for this use case over the specified time period.
+        trend:
+          type: number
+          format: float
+          description: Percentage change in runs compared to the previous equivalent time period.
+        topDepartments:
+          type: string
+          description: Comma-separated list of the top departments using this use case.
+        topAgentId:
+          type: string
+          description: ID of the most-used agent for this use case.
+        topAgentName:
+          type: string
+          description: Name of the most-used agent for this use case.
+        topAgentIcon:
+          $ref: "#/components/schemas/IconConfig"
+          description: Icon of the most-used agent for this use case.
+        topAgentIsDeleted:
+          type: boolean
+          description: Indicates whether the top agent has been deleted.
     AgentsUsageByDepartmentInsight:
       properties:
         department:
@@ -9375,6 +9402,10 @@ components:
               type: array
               items:
                 $ref: "#/components/schemas/PerAgentInsight"
+            topUseCasesInsights:
+              type: array
+              items:
+                $ref: "#/components/schemas/AgentUseCaseInsight"
             agentsUsageByDepartmentInsights:
               type: array
               items:

.speakeasy/workflow.lock

@@ -1,9 +1,9 @@
-speakeasyVersion: 1.761.8
+speakeasyVersion: 1.761.9
 sources:
     Glean API:
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:5fafd8224d41224b85cbb5f39c686e5da647fadcd8211bc9fae3c0834341dae6
-        sourceBlobDigest: sha256:884a6119e9d59c15d47e169eaa496571dae1c106d390990aee38a25cb51e42c3
+        sourceRevisionDigest: sha256:f06a7c8ec8086454bd112c4ecdb30daa84f3d63ce1f794985eb37ebd420488da
+        sourceBlobDigest: sha256:9e4a238d3f64d91abff8b1f6d8220bd273ef6563e7841ff0c3d99d09f9073cfc
         tags:
             - latest
     Glean Client API:
@@ -16,10 +16,10 @@ targets:
     glean:
         source: Glean API
         sourceNamespace: glean-api-specs
-        sourceRevisionDigest: sha256:5fafd8224d41224b85cbb5f39c686e5da647fadcd8211bc9fae3c0834341dae6
-        sourceBlobDigest: sha256:884a6119e9d59c15d47e169eaa496571dae1c106d390990aee38a25cb51e42c3
+        sourceRevisionDigest: sha256:f06a7c8ec8086454bd112c4ecdb30daa84f3d63ce1f794985eb37ebd420488da
+        sourceBlobDigest: sha256:9e4a238d3f64d91abff8b1f6d8220bd273ef6563e7841ff0c3d99d09f9073cfc
         codeSamplesNamespace: glean-api-specs-python-code-samples
-        codeSamplesRevisionDigest: sha256:15a4a6614d94c2111ddad680da00d4286330aadf586e4ceb4f5312fe92377032
+        codeSamplesRevisionDigest: sha256:9823c7e4079098566ee698d458eab8924d70208e658d7b247c6b16cd865e30be
 workflow:
     workflowVersion: 1.0.0
     speakeasyVersion: latest

RELEASES.md

@@ -738,4 +738,14 @@ Based on:
 ### Generated
 - [python v0.12.23] .
 ### Releases
-- [PyPI v0.12.23] https://pypi.org/project/glean-api-client/0.12.23 - .
+- [PyPI v0.12.23] https://pypi.org/project/glean-api-client/0.12.23 - .
+
+## 2026-04-22 02:40:20
+### Changes
+Based on:
+- OpenAPI Doc  
+- Speakeasy CLI 1.761.9 (2.881.4) https://github.com/speakeasy-api/speakeasy
+### Generated
+- [python v0.12.25] .
+### Releases
+- [PyPI v0.12.25] https://pypi.org/project/glean-api-client/0.12.25 - .

docs/models/agentsinsightsv2response.md

@@ -12,6 +12,7 @@
 | `daily_active_user_timeseries`                                                             | [Optional[models.LabeledCountInfo]](../models/labeledcountinfo.md)                         | :heavy_minus_sign:                                                                         | N/A                                                                                        |
 | `shared_agents_count`                                                                      | *Optional[int]*                                                                            | :heavy_minus_sign:                                                                         | Total number of shared agents.                                                             |
 | `top_agents_insights`                                                                      | List[[models.PerAgentInsight](../models/peragentinsight.md)]                               | :heavy_minus_sign:                                                                         | N/A                                                                                        |
+| `top_use_cases_insights`                                                                   | List[[models.AgentUseCaseInsight](../models/agentusecaseinsight.md)]                       | :heavy_minus_sign:                                                                         | N/A                                                                                        |
 | `agents_usage_by_department_insights`                                                      | List[[models.AgentsUsageByDepartmentInsight](../models/agentsusagebydepartmentinsight.md)] | :heavy_minus_sign:                                                                         | N/A                                                                                        |
 | `agent_users_insights`                                                                     | List[[models.AgentUsersInsight](../models/agentusersinsight.md)]                           | :heavy_minus_sign:                                                                         | N/A                                                                                        |
 | `agents_time_saved_insights`                                                               | List[[models.AgentsTimeSavedInsight](../models/agentstimesavedinsight.md)]                 | :heavy_minus_sign:                                                                         | Insights for agents time saved over the specified time period.                             |