Lista work items (tarefas, bugs, user stories, etc.) de um projeto do Azure DevOps Server, devolvendo um resumo de cada um: ID, tipo, título, estado, responsável, área, sprint e tags.

Use quando o pedido for por um CONJUNTO de itens que atendem a um critério. Para um item específico de que já se conhece o ID, use get_work_item (traz mais detalhe).

Três formas de filtrar, da mais simples para a mais poderosa:

1. Filtros diretos — assignedTo, states, workItemTypes, areaPath. Cobrem a maioria dos casos. Em assignedTo, "@me" resolve para o usuário dono do PAT configurado no servidor.

2. queryId — executa uma consulta salva (Shared Query) pelo seu GUID.

3. wiql — uma consulta WIQL completa, para critérios que os filtros diretos não expressam (datas, campos customizados, operadores CONTAINS, etc.). Quando wiql é informado, os filtros diretos são ignorados.

O parâmetro project pode ser omitido se o servidor tiver ADO_DEFAULT_PROJECT configurado. Retorna no máximo 200 itens por chamada (padrão 50); use skip para paginar e leia totalMatched para saber quantos a consulta encontrou no total.

Exemplos de pedidos que devem acionar esta tool:

• "quais bugs estão abertos no projeto Portal?"

• "me mostra as tarefas atribuídas a mim"

• "lista as user stories da sprint atual que ainda estão em New"

• "quantos itens ativos existem na área Portal\Backend?"

• "roda a consulta salva 3f2b...c1 e me resume o resultado"

Retorna todos os detalhes de UM work item do Azure DevOps Server a partir do seu ID: título, descrição, critérios de aceite, estado, responsável, área, sprint, prioridade, tags, datas, autor, campos customizados e links com outros work items.

Use quando o ID já é conhecido — porque o usuário o citou, ou porque veio de uma chamada anterior a list_work_items. Se o ID ainda não é conhecido, chame list_work_items primeiro.

Parâmetros:

• id (obrigatório): o número do work item, como aparece na interface web.

• project: opcional; se omitido usa ADO_DEFAULT_PROJECT.

• expand: "all" (padrão) traz tudo, inclusive relações; "none" traz só os campos básicos e é mais econômico quando só se quer conferir estado ou título.

• fields: lista de campos específicos por nome de referência (ex.: ["System.Title", "Custom.Sistema"]). Exige expand: "none" — a API não aceita os dois juntos.

Exemplos de pedidos que devem acionar esta tool:

• "o que é o bug 1234?"

• "me mostra os detalhes do work item 4521"

• "qual é o critério de aceite da US 890?"

• "quem está responsável pela tarefa 77 e em que estado ela está?"

Cria um novo work item em um projeto do Azure DevOps Server e devolve o item criado, já com o ID gerado e o link para abri-lo no navegador.

Use quando o pedido for para registrar algo novo: uma tarefa, um bug, uma história. Esta operação ESCREVE no Azure DevOps e é visível para o time — confirme com o usuário o tipo, o título e o projeto antes de chamar, se algum deles estiver ambíguo.

Parâmetros:

• workItemType (obrigatório): o nome exato do tipo no processo do projeto — "Task", "Bug", "User Story", "Product Backlog Item", "Epic", "Feature". Tipos variam entre processos (Agile, Scrum, CMMI); se der erro de tipo inexistente, confirme com o usuário.

• title (obrigatório): título do item, até 255 caracteres.

• project: opcional se ADO_DEFAULT_PROJECT estiver configurado.

• description e acceptanceCriteria: texto em HTML (, , ), nunca Markdown nem CDATA.

• assignedTo, areaPath, iterationPath, priority (1 a 4), tags, parentId.

• additionalFields: qualquer outro campo, inclusive customizados, por nome de referência. Ex.: {"Custom.Sistema": "Portal", "Microsoft.VSTS.Scheduling.StoryPoints": 5}.

Exemplos de pedidos que devem acionar esta tool:

• "abre um bug no projeto Portal: o login falha com senha correta"

• "cria uma tarefa para revisar o contrato, atribuída à Ana, prioridade 2"

• "registra uma user story de exportação em CSV como filha do épico 1200"

Atualiza campos de um work item existente do Azure DevOps Server e/ou registra um comentário na aba Discussion. Devolve o item já atualizado e a lista de campos alterados.

Use para mudar estado, responsável, título, descrição, prioridade, sprint, tags, campos customizados, ou apenas para deixar um comentário. Só envia os campos informados — os demais permanecem como estão. Esta operação ESCREVE no Azure DevOps e gera notificação para os envolvidos.

Parâmetros:

• id (obrigatório): o número do work item.

• Pelo menos um campo além do id precisa ser informado.

• state: precisa ser um estado válido para o tipo e a transição precisa ser permitida pelo processo (ex.: em muitos processos não se vai de "New" direto para "Closed").

• comment: vai para o histórico de discussão (System.History), em HTML.

• tags: SUBSTITUI a lista inteira de tags (passe [] para limpar todas). Para alteração incremental use tagsToAdd e/ou tagsToRemove, que preservam as demais. Não combine "tags" com "tagsToAdd"/"tagsToRemove" na mesma chamada.

• description e demais campos de texto longo: HTML, nunca Markdown nem CDATA.

• additionalFields: outros campos por nome de referência.

Exemplos de pedidos que devem acionar esta tool:

• "fecha o bug 1234"

• "passa a tarefa 88 para Active e atribui ao Carlos"

• "comenta no item 4521 que o deploy foi feito em produção"

• "adiciona a tag regressao no bug 1234 sem mexer nas outras tags"

• "move a US 890 para a sprint 13"