Ferramentas de desenvolvimento
Sentry no seu produto e nos seus agentes de IA, por uma API
O toolkit do Sentry cobre organizações, projetos, issues e eventos de erro com stack trace, tags e contexto. Seu cliente conecta uma vez com uma API key, e seu produto ou agente de IA chama cada operação pelo Connect, que guarda a credencial e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/sentry_list_organizations/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"query": "<query>"
}
}Como funciona
Do cliente conectado à primeira chamada no Sentry.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Sentry. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Sentry.
Mostrar erros dentro do seu produto
Liste as issues não resolvidas de um cliente com contagem de eventos e usuários para seu SaaS mostrar o que está quebrando, ao lado do app monitorado.
Fechar o ciclo a partir do seu tracker
Resolva, arquive ou atribua uma issue do Sentry quando o ticket correspondente mudar de estado no seu produto.
Triagem com agente de IA
Deixe um agente ler uma issue, buscar o evento mais recente com o stack trace e os valores de tag mais frequentes e sugerir quem deve olhar.
Tools
11 tools do Sentry
- Listar organizaçõesGETLista as organizações que o token alcança neste local de armazenamento de dados, cada uma com id, slug e name. O slug é o organization_id_or_slug que as outras ferramentas pedem. Retorna até 100.
- Listar projetosGETLista os projetos de uma organização, cada um com id, slug, name e platform. O slug é o project_id_or_slug que as ferramentas de projeto pedem. Retorna até 100; refine com query.
- Obter projetoGETRetorna um projeto com name, platform, times, status e configurações.
- Listar issuesGETLista as issues de uma organização, por padrão as não resolvidas ordenadas por última ocorrência. Cada issue traz id, shortId, title, status, level, contagem de eventos, contagem de usuários, primeira e última ocorrência e projeto. Retorna até 100; refine com query, project e statsPeriod.
- Obter issueGETRetorna uma issue com title, culprit, status, level, responsável, contagens, primeira e última ocorrência, release e principais tags.
- Atualizar issuePUTResolve, arquiva, reabre, atribui ou altera a prioridade de uma issue. Só os campos enviados mudam. Para arquivar, envie status ignored com um substatus, e a condição em statusDetails quando for archived_until_condition_met.
- Listar eventos da issueGETLista os eventos de uma issue, 100 por página. Com full true cada evento traz o stack trace, e a página cai para 10.
- Obter evento da issueGETRetorna um evento de uma issue com stack trace, tags, contexto, breadcrumbs e request. Use latest, oldest ou recommended como event_id quando não tiver um id de evento.
- Obter tag da issueGETRetorna os valores mais frequentes de uma tag nos eventos de uma issue, com a contagem de cada um, como os navegadores ou releases afetados.
- Listar eventos do projetoGETLista os eventos de erro de um projeto, 100 por página. Com full true cada evento traz o stack trace, e a página cai para 10.
Chave de API
O cliente cola a chave do app numa tela do Connect, ou o seu sistema envia a chave por POST /api/customer-toolkits, sem tela.
Na conexão, o cliente informa também {region}: o endereço da conta dele na API do app.
Perguntas sobre o toolkit do Sentry
Preciso implementar a API do Sentry?
Não. O Connect já traz 11 tools do Sentry descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Sentry?
Pelo modo que o toolkit aceita: Chave de API. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
