Comece pelas leituras

Depois do login, use estas ferramentas:

FerramentaFinalidade
work_capabilitiesConsultar o catálogo de operações oferecido pela versão conectada.
resolve_work_contextResolver organizações, workspaces e projetos visíveis.
list_projectsListar projetos autorizados.
search_issuesPesquisar issues com os filtros anunciados no schema.
get_issueConsultar uma issue no contexto exigido pelo schema.

Exemplos de pedidos ao assistente:

Mostre meu contexto no Órbita e os projetos aos quais tenho acesso.

Liste as issues abertas deste projeto, sem alterar nada.

Leia esta issue e resuma seus comentários e atividade.

Dispatcher fechado

work_execute recebe o nome de uma operação do catálogo, input, mode e, quando necessário, confirmationToken. Não é um cliente HTTP genérico: não aceita URL, método HTTP ou SQL arbitrários.

Uma leitura simples, quando sua sessão já resolve uma organização, pode usar:

{
  "operation": "list_projects",
  "input": {},
  "mode": "execute"
}

Quando houver mais de uma organização, selecione o contexto explicitamente usando os identificadores retornados pelo servidor. Consulte o schema anunciado para os argumentos da operação em vez de reutilizar o formato de outra ferramenta ou da API pública.

Escritas e limites

Ferramentas como create_issue, update_issue, change_issue_status e add_issue_comment respeitam o usuário autenticado. Operações marcadas como sensíveis exigem o fluxo de prévia e confirmação.

A presença de um campo idempotencyKey em um consumidor não comprova idempotência em todos os endpoints do backend. Confira o contrato específico antes de repetir uma escrita cuja resposta se perdeu.