Skip to content

Commit fb99215

Browse files
authored
Update workitems.ts to make getting child workitems clearer for LLMs (#416)
In my experience GPT5 (and other models I presume) don't know expanding relations gives you the ability to get child items. Expanding on the description of a tool's parameter might help guide it better. I think it deserves explicit callout as getting child items (of e.g. an epic) is a very useful and potentially common operation. ## GitHub issue number #415 (#414) ## **Associated Risks** Making tool arg description longer uses more context window. Plus prioritizing one value might make others less likely to be used by LLM. ## ✅ **PR Checklist** - [x] **I have read the [contribution guidelines](https://github.com/microsoft/azure-devops-mcp/blob/main/CONTRIBUTING.md)** - [x] **I have read the [code of conduct guidelines](https://github.com/microsoft/azure-devops-mcp/blob/main/CODE_OF_CONDUCT.md)** - [x] Title of the pull request is clear and informative. - [x] 👌 Code hygiene - [x] 🔭 Telemetry added, updated, or N/A - [x] 📄 Documentation added, updated, or N/A - [x] 🛡️ Automated tests added, or N/A ## 🧪 **How did you test it?** Manually asking GPT5 to summarize child items of an epic.
1 parent 3d969ea commit fb99215

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

src/tools/workitems.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -172,7 +172,7 @@ function configureWorkItemTools(server: McpServer, tokenProvider: () => Promise<
172172
.enum(["all", "fields", "links", "none", "relations"])
173173
.describe("Optional expand parameter to include additional details in the response.")
174174
.optional()
175-
.describe("Expand options include 'all', 'fields', 'links', 'none', and 'relations'. Defaults to 'none'."),
175+
.describe("Expand options include 'all', 'fields', 'links', 'none', and 'relations'. Relations can be used to get child workitems. Defaults to 'none'."),
176176
},
177177
async ({ id, project, fields, asOf, expand }) => {
178178
const connection = await connectionProvider();

0 commit comments

Comments
 (0)