Jira Connector
Propojení Jira s Siesta AI
- V Konektory zvol Add Connection a vyber Jira.
- Vyplň URL, Username a Password (API token) a nastav Shared nebo Private.
- Volitelně uprav, které operace jsou povolené.
Přehled
Tento konektor poskytuje programové rozhraní pro práci s Jira (Atlassian). Umožňuje vytváření, čtení, vyhledávání, aktualizaci a přiřazování Jira issues (tickets) napříč projekty.
Navrženo pro:
- Incident a ops automatizaci
- Engineering workflow orchestration
- Synchronizaci externích systémů (CRM, monitoring, AI agenti)
- Auditovatelné ticket-based procesy
Autentizace a bezpečnost
- Konektor využívá oficiální Jira REST API.
- Autentizace probíhá pomocí Atlassian účtu (OAuth / API token).
- Uživatel je identifikován pomocí Atlassian Account ID, ne e-mailu.
- Oprávnění jsou řízena přímo na úrovni Jira instance.
Pokud uživatel nemá právo vidět issue, konektor ho také neuvidí.
Základní pojmy
- IssueKey: ID ticketu (např.
PROJ-123). - ProjectKey: klíč Jira projektu (např.
PROJ). - AccountId: unikátní identifikátor uživatele v Atlassian ekosystému.
- JQL: Jira Query Language.
1. Ticket Creation
1.1 CreateTicketAsync
Popis
Vytvoří nový Jira issue v zadaném projektu.
Vstupní parametry
| Parametr | Typ | Povinný | Popis |
|---|---|---|---|
| projectKey | String | Ano | Klíč Jira projektu. |
| issueType | String | Ano | Typ issue (Task, Bug, Story, ...). |
| summary | String | Ano | Krátký název issue. |
| description | String | Ne | Detailní popis. |
| assigneeId | String | Ne | Atlassian Account ID uživatele. |
Chování
- IssueType musí existovat v projektu.
- Neprovádí fallback ani mapování typů.
- Špatná kombinace = fail.
2. Ticket Assignment
2.1 AssignTicketAsync
Popis
Přiřadí existující issue konkrétnímu uživateli.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| issueKey | String | Ano |
| assigneeAccountId | String | Ano |
Poznámka Jira ignoruje e-maily. Account ID je jediný spolehlivý identifikátor.
3. Ticket Retrieval
3.1 GetTicketAsync
Popis
Vrátí detail issue podle issueKey.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| issueKey | String | Ano |
3.2 GetTicketsByProjectAsync
Popis
Vrátí issues patřící do konkrétního projektu.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| projectKey | String | Ano |
| maxResults | Int | Ne |
3.3 GetTicketsByUserAsync
Popis
Vrátí issues přiřazené konkrétnímu uživateli.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| assigneeEmail | String | Ano |
| maxResults | Int | Ne |
4. Ticket Update
4.1 UpdateTicketAsync
Popis
Aktualizuje summary a/nebo description existujícího issue.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| issueKey | String | Ano |
| summary | String | Ne |
| description | String | Ne |
Chování
- Aktualizují se pouze poskytnutá pole.
- Neprovádí validaci workflow statusu.
5. Search a Query
5.1 SearchTicketsAsync
Popis
Vyhledává issues pomocí JQL dotazu.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| jql | String | Ano |
| maxResults | Int | Ne |
Příklad JQL
project = PROJ AND status = "To Do"
Špatné JQL vrací okamžitou chybu.
6. Project a User Operations
6.1 GetAllProjectsAsync
Popis
Vrátí seznam projektů dostupných aktuálnímu uživateli.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| maxResults | Int | Ne |
6.2 GetUserAsync
Popis
Vrátí informace o uživateli podle Account ID.
Vstupní parametry
| Parametr | Typ | Povinný |
|---|---|---|
| accountId | String | Ano |
Designové principy
- Account ID > e-mail (GDPR a realita Atlassianu).
- Explicitní vstupy bez domýšlení.
- Fail-fast chování na chybných requestech.
- Respektování Jira workflow pravidel.
Shrnutí
Jira konektor poskytuje přímý, bezpečný a auditovatelný přístup k Jira issues a projektům. Je vhodný pro automatizované ticketování, incident agenty, engineering productivity tooling a enterprise workflow integrace.