mirror of
https://github.com/google/adk-docs.git
synced 2026-09-14 16:16:59 +08:00
Kristopher Overholt
58f3aaebca
* Replace google.github.io/adk-docs URLs and /adk-docs/ paths with adk.dev Migrate all hardcoded documentation references to use the new custom domain. Update root-relative links to remove the /adk-docs/ subpath prefix since the site will be served from the root of adk.dev. * Additional fixes
242 lines
9.3 KiB
Markdown
242 lines
9.3 KiB
Markdown
---
|
|
catalog_title: StackOne
|
|
catalog_description: Connect agents to 200+ SaaS providers
|
|
catalog_icon: /integrations/assets/stackone.png
|
|
catalog_tags: ["connectors"]
|
|
---
|
|
|
|
# StackOne plugin for ADK
|
|
|
|
<div class="language-support-tag">
|
|
<span class="lst-supported">Supported in ADK</span><span class="lst-python">Python</span>
|
|
</div>
|
|
|
|
The [StackOne ADK Plugin](https://github.com/StackOneHQ/stackone-adk-plugin)
|
|
connects your ADK agent to hundreds of providers through
|
|
[StackOne's](https://stackone.com) unified AI Integration gateway. Instead of manually defining tool functions for each API, this plugin dynamically discovers available tools from your connected providers and exposes them as native tools in ADK. It supports Human Resources Information Systems (HRIS), Applicant Tracking Systems (ATS), Customer Relationship Management (CRM), productivity and scheduling tools, and many more [integrations](https://www.stackone.com/connectors).
|
|
|
|
## Use cases
|
|
|
|
- **Sales and Revenue Operations**: Build agents that find leads in your CRM (e.g. HubSpot, Salesforce), enrich contact data, draft personalized outreach, and log activity back — all within one conversation.
|
|
|
|
- **People Operations**: Create agents that screen candidates in your ATS (e.g. Greenhouse, Ashby), check availability in your calendar tool (e.g. Google Calendar, Calendly), collect interview scorecards, move applicants through pipeline stages, and automate onboarding into your HRIS (e.g. BambooHR, Workday) — covering the full employee lifecycle without manual intervention.
|
|
|
|
- **Marketing Automation**: Build campaign agents that sync audience segments from your CRM to your email platform (e.g. Mailchimp, Klaviyo), trigger email sequences, and report on engagement metrics across channels.
|
|
|
|
- **Product Delivery**: Create agents that triage incoming feedback from your support tools (e.g. Intercom, Zendesk, Slack), prioritize and create issues in your project management tool (e.g. Linear, Jira), and resolve incidents using insights from an observability platform (e.g. PagerDuty, Datadog) — uniting product research, delivery, and reliability in a single workflow.
|
|
|
|
## Prerequisites
|
|
|
|
- A [StackOne account](https://app.stackone.com) with at least one connected
|
|
provider
|
|
- A StackOne API key from the
|
|
[StackOne Dashboard](https://app.stackone.com)
|
|
- A [Gemini API key](https://aistudio.google.com/apikey)
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
pip install stackone-adk
|
|
```
|
|
|
|
Or with uv:
|
|
|
|
```bash
|
|
uv add stackone-adk
|
|
```
|
|
|
|
## Use with agent
|
|
|
|
!!! tip "Environment variables"
|
|
|
|
Set your API keys as environment variables before running the examples below:
|
|
|
|
```bash
|
|
export STACKONE_API_KEY="your-stackone-api-key"
|
|
export GOOGLE_API_KEY="your-google-api-key"
|
|
```
|
|
|
|
Once `STACKONE_API_KEY` is set, the plugin automatically reads it and discovers your connected accounts.
|
|
|
|
=== "Python"
|
|
|
|
=== "With App (Recommended)"
|
|
|
|
```python
|
|
import asyncio
|
|
|
|
from google.adk.agents import Agent
|
|
from google.adk.apps import App
|
|
from google.adk.runners import InMemoryRunner
|
|
from stackone_adk import StackOnePlugin
|
|
|
|
|
|
async def main():
|
|
plugin = StackOnePlugin()
|
|
# Or scope to a specific account:
|
|
# plugin = StackOnePlugin(account_id="YOUR_ACCOUNT_ID")
|
|
|
|
tools = plugin.get_tools()
|
|
print(f"Discovered {len(tools)} tools")
|
|
|
|
agent = Agent(
|
|
model="gemini-2.5-flash",
|
|
name="scheduling_agent",
|
|
description="Manages scheduling, HR, and CRM through StackOne.",
|
|
instruction=(
|
|
"You are a helpful assistant powered by StackOne. "
|
|
"You help users manage their scheduling, HR, and CRM tasks "
|
|
"by using the available tools.\n\n"
|
|
"Always be helpful and provide clear, organized responses."
|
|
),
|
|
tools=tools,
|
|
)
|
|
|
|
app = App(
|
|
name="scheduling_app",
|
|
root_agent=agent,
|
|
plugins=[plugin],
|
|
)
|
|
|
|
async with InMemoryRunner(app=app) as runner:
|
|
events = await runner.run_debug(
|
|
"Get my most recent scheduled meeting from Calendly.",
|
|
quiet=True,
|
|
)
|
|
# Extract the agent's final text response
|
|
for event in reversed(events):
|
|
if event.content and event.content.parts:
|
|
text_parts = [p.text for p in event.content.parts if p.text]
|
|
if text_parts:
|
|
print("".join(text_parts))
|
|
break
|
|
|
|
|
|
asyncio.run(main())
|
|
```
|
|
|
|
=== "With Runner Directly"
|
|
|
|
```python
|
|
import asyncio
|
|
|
|
from google.adk.agents import Agent
|
|
from google.adk.runners import InMemoryRunner
|
|
from stackone_adk import StackOnePlugin
|
|
|
|
|
|
async def main():
|
|
plugin = StackOnePlugin()
|
|
# Or scope to a specific account:
|
|
# plugin = StackOnePlugin(account_id="YOUR_ACCOUNT_ID")
|
|
|
|
tools = plugin.get_tools()
|
|
print(f"Discovered {len(tools)} tools")
|
|
|
|
agent = Agent(
|
|
model="gemini-2.5-flash",
|
|
name="scheduling_agent",
|
|
description="Manages scheduling, HR, and CRM through StackOne.",
|
|
instruction=(
|
|
"You are a helpful assistant powered by StackOne. "
|
|
"You help users manage their scheduling, HR, and CRM tasks "
|
|
"by using the available tools.\n\n"
|
|
"Always be helpful and provide clear, organized responses."
|
|
),
|
|
tools=tools,
|
|
)
|
|
|
|
async with InMemoryRunner(
|
|
app_name="scheduling_app", agent=agent
|
|
) as runner:
|
|
events = await runner.run_debug(
|
|
"Get my most recent scheduled meeting from Calendly.",
|
|
quiet=True,
|
|
)
|
|
# Extract the agent's final text response
|
|
for event in reversed(events):
|
|
if event.content and event.content.parts:
|
|
text_parts = [p.text for p in event.content.parts if p.text]
|
|
if text_parts:
|
|
print("".join(text_parts))
|
|
break
|
|
|
|
|
|
asyncio.run(main())
|
|
```
|
|
|
|
## Available tools
|
|
|
|
Unlike integrations with a fixed set of tools, StackOne tools are **dynamically
|
|
discovered** from your connected providers via the StackOne API. The available
|
|
tools depend on which SaaS providers you have connected in your
|
|
[StackOne Dashboard](https://app.stackone.com).
|
|
|
|
To list discovered tools:
|
|
|
|
```python
|
|
plugin = StackOnePlugin(account_id="YOUR_ACCOUNT_ID") # Optional: omit to use all connected accounts
|
|
for tool in plugin.get_tools():
|
|
print(f"{tool.name}: {tool.description}")
|
|
```
|
|
|
|
### Supported integration categories
|
|
|
|
Category | Example providers
|
|
-------- | -----------------
|
|
HRIS | HiBob, BambooHR, Workday, SAP SuccessFactors, Personio, Gusto
|
|
ATS | Greenhouse, Ashby, Lever, Bullhorn, SmartRecruiters, Teamtailor
|
|
CRM & Sales | Salesforce, HubSpot, Pipedrive, Zoho CRM, Close, Copper
|
|
Marketing | Mailchimp, Klaviyo, ActiveCampaign, Brevo, GetResponse
|
|
Ticketing & Support | Zendesk, Freshdesk, Jira, ServiceNow, PagerDuty, Linear
|
|
Productivity | Asana, ClickUp, Slack, Microsoft Teams, Notion, Confluence
|
|
Scheduling | Calendly, Cal.com
|
|
LMS & Learning | 360Learning, Docebo, Go1, Cornerstone, LinkedIn Learning
|
|
Commerce | Shopify, BigCommerce, WooCommerce, Etsy
|
|
Developer Tools | GitHub, GitLab, Twilio
|
|
|
|
For a complete list of 200+ supported providers, visit the
|
|
[StackOne integrations page](https://www.stackone.com/connectors).
|
|
|
|
## Configuration
|
|
|
|
### Plugin parameters
|
|
|
|
Parameter | Type | Default | Description
|
|
--------- | ---- | ------- | -----------
|
|
`api_key` | `str | None` | `None` | StackOne API key. Falls back to `STACKONE_API_KEY` env var.
|
|
`account_id` | `str | None` | `None` | Default account ID for all tools.
|
|
`base_url` | `str | None` | `None` | API URL override (default: `https://api.stackone.com`).
|
|
`plugin_name` | `str` | `"stackone_plugin"` | Plugin identifier for ADK.
|
|
`providers` | `list[str] | None` | `None` | Filter by provider names (e.g., `["calendly", "hibob"]`).
|
|
`actions` | `list[str] | None` | `None` | Filter by action patterns using glob syntax.
|
|
`account_ids` | `list[str] | None` | `None` | Scope tools to specific connected account IDs.
|
|
|
|
### Tool filtering
|
|
|
|
Filter tools by provider, action pattern, account ID, or any combination:
|
|
|
|
```python
|
|
# Specify accounts
|
|
plugin = StackOnePlugin(account_ids=["acct-hibob-1", "acct-bamboohr-1"])
|
|
|
|
# Read-only operations
|
|
plugin = StackOnePlugin(actions=["*_list_*", "*_get_*"])
|
|
|
|
# Specific actions with glob patterns
|
|
plugin = StackOnePlugin(actions=["calendly_list_events", "calendly_get_event_*"])
|
|
|
|
# Combined filters
|
|
plugin = StackOnePlugin(
|
|
actions=["*_list_*", "*_get_*"],
|
|
account_ids=["acct-hibob-1"],
|
|
)
|
|
```
|
|
|
|
## Additional resources
|
|
|
|
- [StackOne ADK Plugin Repository](https://github.com/StackOneHQ/stackone-adk-plugin)
|
|
- [StackOne Documentation](https://docs.stackone.com/)
|
|
- [StackOne Dashboard](https://app.stackone.com)
|
|
- [StackOne Python AI SDK](https://github.com/StackOneHQ/stackone-ai-python)
|