Files
adk-python/contributing/samples/application_integration_agent
Josh Soref aa1233608a chore: Fix spelling
Merge https://github.com/google/adk-python/pull/2447

This PR corrects misspellings identified by the [check-spelling action](https://github.com/marketplace/actions/check-spelling)

The misspellings have been reported at https://github.com/jsoref/adk-python/actions/runs/16840838898/attempts/1#summary-47711379253

The action reports that the changes in this PR would make it happy: https://github.com/jsoref/adk-python/actions/runs/16840839269/attempts/1#summary-47711380479

Note: while I use tooling to identify errors, the tooling doesn't _actually_ provide the corrections, I'm picking them on my own. I'm a human, and I may make mistakes.

I've included a couple of changes to make CI happy. Personally, I object to CI being in a state of "random drive by person who adds a blank line in the middle of a file must fix all the preexisting bugs in the file", but that appears to be the state for this repository.

COPYBARA_INTEGRATE_REVIEW=https://github.com/google/adk-python/pull/2447 from jsoref:spelling d85398e7fd154d124d477c6af6181481a01f34e0
PiperOrigin-RevId: 827629615
2025-11-03 13:33:53 -08:00
..
2025-11-03 13:33:53 -08:00
2025-11-03 13:33:53 -08:00

Application Integration Agent Sample

Introduction

This sample demonstrates how to use the ApplicationIntegrationToolset within an ADK agent to interact with external applications, specifically Jira in this case. The agent (agent.py) is configured to manage Jira issues using a pre-configured Application Integration connection.

Prerequisites

  1. Set up Integration Connection:

    • You need an existing Integration connection configured to interact with your Jira instance. Follow the documentation to provision the Integration Connector in Google Cloud and then use this documentation to create an Jira connection. Note the Connection Name, Project ID, and Location of your connection.
  2. Configure Environment Variables:

    • Create a .env file in the same directory as agent.py (or add to your existing one).
    • Add the following variables to the .env file, replacing the placeholder values with your actual connection details:
    CONNECTION_NAME=<YOUR_JIRA_CONNECTION_NAME>
    CONNECTION_PROJECT=<YOUR_GOOGLE_CLOUD_PROJECT_ID>
    CONNECTION_LOCATION=<YOUR_CONNECTION_LOCATION>
    

How to Use

  1. Install Dependencies: Ensure you have the necessary libraries installed (e.g., google-adk, python-dotenv).
  2. Run the Agent: Execute the agent script from your terminal:
    python agent.py
    
  3. Interact: Once the agent starts, you can interact with it by typing prompts related to Jira issue management.

Sample Prompts

Here are some examples of how you can interact with the agent:

  • Can you list me all the issues ?
  • Can you list me all the projects ?
  • Can you create an issue: "Bug in product XYZ" in project ABC ?