Jira

Use Jira with Agno agents.

Enable Agno agents to move beyond simple chat and into the core of software development and IT operations by programmatically reading, writing, and managing tasks, epics, and sprints by integrating with Jira.

from agno.agent import Agent
from agno.tools.jira import JiraTools

# ---------------------------------------------------------------------------
# Create Agent
# ---------------------------------------------------------------------------


# Example 1: Enable all Jira functions
agent_all = Agent(
    tools=[
        JiraTools(
            all=True,  # Enable all Jira functions
        )
    ],
    markdown=True,
)

# Example 2: Enable specific Jira functions only
agent_specific = Agent(
    tools=[
        JiraTools(
            enable_search_issues=True,
            enable_get_issue=True,
            enable_create_issue=False,
        )
    ],
    markdown=True,
)

# Example 3: Default behavior with all functions enabled
agent = Agent(
    tools=[
        JiraTools(
            enable_search_issues=True,
            enable_get_issue=True,
            enable_create_issue=True,
            enable_add_worklog=True,
        )
    ],
    markdown=True,
)
# Example 4: Agent with worklog and comment capabilities
agent_worklog = Agent(
    tools=[
        JiraTools(
            enable_get_issue=True,
            enable_add_worklog=True,
            enable_add_comment=True,
        )
    ],
    markdown=True,
)

# Example usage with all functions enabled

# ---------------------------------------------------------------------------
# Run Agent
# ---------------------------------------------------------------------------
if __name__ == "__main__":
    print("=== Example 1: Using all Jira functions ===")
    agent_all.print_response(
        "Find all issues in project PROJ and create a summary report", markdown=True
    )

    # Example usage with specific functions only
    print("\n=== Example 2: Using specific Jira functions (read-only) ===")
    agent_specific.print_response("Find all issues in project PROJ", markdown=True)

    # Example usage with default configuration
    print("\n=== Example 3: Default Jira agent usage ===")
    agent.print_response("Find all issues in project PROJ", markdown=True)

    agent.print_response("Get details for issue PROJ-123", markdown=True)

    # Example usage with worklog functionality
    print("\n=== Example 4: Adding worklog entries ===")
    agent_worklog.print_response(
        "Log 2 hours of work on issue PROJ-123 with comment 'Implemented new feature'",
        markdown=True,
    )

    agent_worklog.print_response(
        "Add a worklog of 30 minutes to PROJ-456 for code review", markdown=True
    )

Run the Example

# Clone and setup repo
git clone https://github.com/agno-agi/agno.git
cd agno/cookbook/91_tools

# Create and activate virtual environment
./scripts/demo_setup.sh
source .venvs/demo/bin/activate

python jira_tools.py

For details, see Jira cookbook.