> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Jira

## 概要

ElevenLabs AIエージェントをJira Cloudに接続して、課題の管理、プロジェクトの追跡、サポートワークフローの自動化を行えます。このインテグレーションにより、エージェントは課題の作成・更新、ワークフローによる課題の遷移、エスカレーションのための関連チケットのリンク、プロジェクト横断の検索を行えます。

## 機能

| 機能           | 対応状況                |
| ------------ | ------------------- |
| ゼロ保持モード（ZRM） | 非対応                 |
| ツール内の添付ファイル  | 非対応 — ツールはテキストのみを処理 |

## 設定

このインテグレーションでは、Basic認証を使用する**Jira APIトークン**を使用します。Atlassianアカウントのメールアドレス、APIトークン、Jira Cloudサブドメインが必要です。

#### APIトークンを生成

[Atlassian APIトークン管理](https://id.atlassian.com/manage-profile/security/api-tokens)に移動し、**Create API token**をクリックします。トークンをコピーしてください。一度閉じると再表示できません。

#### Jiraサブドメインを確認

サブドメインはJira Cloud URLの最初の部分です。たとえば、JiraのURLが`mycompany.atlassian.net`の場合、サブドメインは`mycompany`です。

#### ElevenLabsで接続

ElevenLabsのインテグレーション設定で、次の情報を入力します。

* **Email** - Atlassianアカウントのメールアドレス
* **API Token** - ステップ1で生成したトークン
* **Jira Subdomain** - ステップ2のサブドメイン

> **Note**
>
> APIトークンはデフォルトで1年後に期限切れになります。エージェントがJiraにアクセスできなくなった場合は、
> 新しいトークンを生成して接続を更新してください。

## 発信者の特定

`jira_search_issues`ツールでは、検索対象を特定ユーザーのチケットに絞り込むため、`labels`パラメータが必要です。この機能は、Jiraワークフローによって各課題に発信者を特定するラベルが付与されることを前提としています。たとえば、`jane.smith@example.com`のようなメールアドレスを、`jane-smith-at-example-com`のようなラベルに変換します。

これを自動化するには、アプリケーションから発信者の識別子を受け取る[動的変数](/docs/ja/eleven-agents/customization/personalization/dynamic-variables)として`labels`フィールドを設定します。これにより、エージェントは毎回の通話で発信者にメールアドレスを尋ねる必要がなくなります。

> **Note**
>
> Jiraのラベルにはスペースを含められません。一般的には、`@`を`-at-`に、`.`を
> `-`に置き換えます（例：`jane-smith-at-example-com`）。`jira_search_issues`ツールはラベルを完全一致で検索するため、
> 指定する値は課題上のラベルと一致している必要があります。

## 仕組み

#### サポートチケットの作成

#### 発信者の特定

エージェントは、メールアドレスまたはlabelsフィールドに設定された別の識別子で発信者を特定します。

#### 詳細を収集

エージェントは、何が起きたか、重大度、関連するコンテキストなど、問題に関する情報を発信者から収集します。

#### 課題を作成

エージェントは、適切なプロジェクトに、適切な課題タイプ、優先度、説明を設定してJira課題を作成します。

#### 発信者に確認

エージェントは作成したチケット番号を読み上げ、発信者がフォローアップ時に参照できるようにします。

#### サービスデスクでの解決

#### チケットを検索

エージェントはキー（例：PROJ-123）でJira課題を取得し、現在のステータス、優先度、概要を読み上げます。

#### 解決メモを追加

エージェントは、実施した手順や収集した情報など、会話の詳細を含むコメントを課題に追加します。

#### チケットをクローズ

エージェントは、利用可能なワークフロー遷移を使用して、課題を解決済みまたはクローズ済みのステータスに移行します。

## システムプロンプトの例

#### システムプロンプトの例を表示

```text
# Personality

You are a helpful IT support agent responsible for managing support tickets in Jira. Be friendly, professional, and efficient.

# Environment

You operate in a support setting via voice or chat, where you help users report issues, check ticket status, and manage existing requests.

# Tone

Begin by asking how you can help. If the caller has an existing issue, ask whether they have the ticket number. If they are reporting a new issue, collect details about the problem.

Ask one question at a time and wait for the response before proceeding.

# Goal

For new issues:
- Collect a clear description of the problem
- Determine severity and urgency
- Create the ticket in the appropriate project with the right issue type and priority
- Read back the ticket number

For existing issues:
- If the caller provides a ticket number, look it up by key
- If the caller wants to check on their issues, search using the labels field
- Provide status updates
- Add comments or update priority when requested
- Always confirm before making changes

# Guardrails

- Do not discuss topics outside of IT support.
- Never expose raw Jira API responses, internal IDs, or technical field names to the caller.
- Always confirm with the caller before creating, updating, or transitioning issues.
```

## 利用可能なツール

| ツール                     | 説明                                                        |
| ----------------------- | --------------------------------------------------------- |
| `jira_create_issue`     | プロジェクト、概要、課題タイプ、優先度などの任意フィールドを指定して課題を作成します。               |
| `jira_get_issue`        | キーを指定して特定の課題の詳細を取得します。                                    |
| `jira_search_issues`    | ラベル、プロジェクト、ステータス、優先度、タイプ、担当者、テキスト、日付範囲で課題を検索します。          |
| `jira_update_issue`     | 既存の課題のフィールド（優先度、担当者、ラベル、説明）を更新します。                        |
| `jira_add_comment`      | 課題にプレーンテキストのコメントを追加します。                                   |
| `jira_get_transitions`  | 課題で利用可能なワークフロー遷移を一覧表示します。                                 |
| `jira_transition_issue` | `jira_get_transitions`の遷移IDを使用して、課題を新しいワークフローステータスに移動します。 |
| `jira_link_issues`      | 2つの課題をリンクします（例：「Blocks」「Duplicate」「Relates」）。             |
| `jira_list_projects`    | 利用可能なプロジェクトとそのキーを一覧表示します。                                 |
| `jira_get_issue_types`  | 利用可能な課題タイプ（例：Bug、Task、Story）を一覧表示します。                     |
| `jira_get_priorities`   | 利用可能な優先度レベルを一覧表示します。                                      |

> **Note**
>
> 課題の説明とコメントはプレーンテキストのみ対応しています。インテグレーションによってJiraの
> Atlassian Document Format（ADF）に自動変換されます。MarkdownとHTMLには対応していません。

## 参考リンク

* [Jira Cloud REST APIドキュメント](https://developer.atlassian.com/cloud/jira/platform/rest/v3/)
* [APIトークンを管理](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/)