Jira
Prepojenie Jira s Siesta AI
- V Pripojení zvoľ Add Connection a vyber Jira.
- Vyplň URL, Username a Password (API token) a nastav Shared alebo Private.
- Voliteľne uprav, ktoré operácie sú povolené.
Prehľad
Toto Pripojenie poskytuje programové rozhranie pre prácu s Jira (Atlassian). Umožňuje vytváranie, čítanie, vyhľadávanie, aktualizáciu a priraďovanie Jira issues (tickets) naprieč projektmi.
Navrhnuté pre:
- Incident a ops automatizáciu
- Engineering workflows orchestration
- Synchronizáciu externých systémov (CRM, monitoring, AI agenti)
- Auditovateľné ticket-based procesy
Autentizácia a bezpečnosť
- Pripojenie využíva oficiálne Jira REST API.
- Autentizácia prebieha pomocou Atlassian účtu (OAuth / API token).
- Používateľ je identifikovaný pomocou Atlassian Account ID, nie e-mailu.
- Oprávnenia sú riadené priamo na úrovni Jira instance.
Ak používateľ nemá právo vidieť issue, Pripojenie ho tiež neuvidí.
Základné pojmy
- IssueKey: ID ticketu (napr.
PROJ-123). - ProjectKey: kľúč Jira projektu (napr.
PROJ). - AccountId: unikátny identifikátor používateľa v Atlassian ekosystéme.
- JQL: Jira Query Language.
1. Vytvorenie ticketu
1.1 CreateTicketAsync
Popis
Vytvorí nový Jira issue v zadanom projekte.
Vstupné parametre
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| projectKey | String | Áno | Kľúč Jira projektu. |
| issueType | String | Áno | Typ issue (Task, Bug, Story, ...). |
| summary | String | Áno | Krátky názov issue. |
| description | String | Nie | Detailný popis. |
| assigneeId | String | Nie | Atlassian Account ID používateľa. |
Správanie
- IssueType musí existovať v projekte.
- Nevykonáva fallback ani mapovanie typov.
- Zlá kombinácia = fail.
2. Priradenie ticketu
2.1 AssignTicketAsync
Popis
Priradí existujúce issue konkrétnemu používateľovi.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| issueKey | String | Áno |
| assigneeAccountId | String | Áno |
Poznámka Jira ignoruje e-maily. Account ID je jediný spoľahlivý identifikátor.
3. Získanie ticketu
3.1 GetTicketAsync
Popis
Vrátí detail issue podľa issueKey.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| issueKey | String | Áno |
3.2 GetTicketsByProjectAsync
Popis
Vrátí issues patriace do konkrétneho projektu.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| projectKey | String | Áno |
| maxResults | Int | Nie |
3.3 GetTicketsByUserAsync
Popis
Vrátí issues priradené konkrétnemu používateľovi.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| assigneeEmail | String | Áno |
| maxResults | Int | Nie |
4. Aktualizácia ticketu
4.1 UpdateTicketAsync
Popis
Aktualizuje summary a/nebo description existujúceho issue.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| issueKey | String | Áno |
| summary | String | Nie |
| description | String | Nie |
Správanie
- Aktualizujú sa iba poskytnuté polia.
- Nevykonáva validáciu workflows statusu.
5. Vyhľadávanie a dotazovanie
5.1 SearchTicketsAsync
Popis
Vyhľadáva issues pomocou JQL dotazu.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| jql | String | Áno |
| maxResults | Int | Nie |
Príklad JQL
project = PROJ AND status = "To Do"
Zlé JQL vracia okamžitú chybu.
6. Operácie s projektom a používateľom
6.1 GetAllProjectsAsync
Popis
Vrátí zoznam projektov dostupných aktuálnemu používateľovi.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| maxResults | Int | Nie |
6.2 GetUserAsync
Popis
Vrátí informácie o používateľovi podľa Account ID.
Vstupné parametre
| Parametr | Typ | Povinný |
|---|---|---|
| accountId | String | Áno |
Dizajnové princípy
- Account ID > e-mail (GDPR a realita Atlassianu).
- Explicitné vstupy bez domýšľania.
- Fail-fast správanie na chybných requestoch.
- Respektovanie Jira workflows pravidiel.
Zhrnutie
Jira Pripojenie poskytuje priamy, bezpečný a auditovateľný prístup k Jira issues a projektom. Je vhodné pre automatizované ticketovanie, incident agentov, engineering productivity tooling a enterprise workflows integráciu.