Ambee | Composio Docs

Overview

SLUG: AMBEE

Description

Ambee provides real-time, hyperlocal environmental data through APIs, offering insights into air quality, weather, pollen, and more.

Authentication Details

API Key

generic_api_key

stringRequired

Connecting to Ambee

Create an auth config

Use the dashboard to create an auth config for the Ambee toolkit. This allows you to connect multiple Ambee accounts to Composio for agents to use.

Select App

Navigate to the Ambee toolkit page and click “Setup Integration”.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Integration”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 from composio.types import auth_scheme
3 
4 # Replace these with your actual values
5 ambee_auth_config_id = "ac_YOUR_AMBEE_CONFIG_ID" # Auth config ID created above
6 user_id = "0000-0000-0000"  # UUID from database/app
7 
8 composio = Composio()
9 
10 def authenticate_toolkit(user_id: str, auth_config_id: str):
11     # Replace this with a method to retrieve an API key from the user.
12     # Or supply your own.
13     user_api_key = input("[!] Enter API key")
14 
15     connection_request = composio.connected_accounts.initiate(
16         user_id=user_id,
17         auth_config_id=auth_config_id,
18         config={"auth_scheme": "API_KEY", "val": user_api_key}
19     )
20 
21     # API Key authentication is immediate - no redirect needed
22     print(f"Successfully connected Ambee for user {user_id}")
23     print(f"Connection status: {connection_request.status}")
24     
25     return connection_request.id
26 
27 
28 connection_id = authenticate_toolkit(user_id, ambee_auth_config_id)
29 
30 # You can verify the connection using:
31 connected_account = composio.connected_accounts.get(connection_id)
32 print(f"Connected account: {connected_account}")

Tools

Executing tools

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["AMBEE"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

AMBEE_AMBEE_GET_AIR_QUALITY_BY_LAT_LNG

Tool Name: Get Air Quality by Latitude and Longitude

Description

Tool to retrieve real-time air quality data for a specific latitude and longitude. use when you need hyper-local air quality readings for given coordinates.

Action Parameters

lat

numberRequired

lng

numberRequired

Action Response

data

arrayRequired

error

string

message

string

successful

booleanRequired

AMBEE_AMBEE_GET_AIR_QUALITY_BY_CITY

Tool Name: Get Air Quality by City

Description

Tool to retrieve real-time air quality data for a specific city. use when you have a valid city name and need current aqi and pollutant levels.

Action Parameters

city

stringRequired

limit

integerDefaults to 1

Action Response

data

objectRequired

error

string

successful

booleanRequired

AMBEE_AMBEE_GET_WILDFIRE_RISK_FORECAST_BY_PLACE

Tool Name: Get Wildfire Risk Forecast by Place

Description

Tool to retrieve wildfire risk forecast for a specific place. use when you need weekly wildfire risk predictions for a location over the next four weeks.

Action Parameters

place

stringRequired

Action Response

data

arrayRequired

error

string

message

stringRequired

successful

booleanRequired

AMBEE_GEOCODE_BY_PLACE

Tool Name: Geocode by Place

Description

Tool to transform a place name or address into geographic coordinates. use after confirming the location name to get precise latitude and longitude.

Action Parameters

place

stringRequired

Action Response

data

arrayRequired

error

string

successful

booleanRequired

AMBEE_GET_AIR_QUALITY_BY_CITY

Tool Name: Get Air Quality by City

Description

Tool to retrieve real-time air quality data for a specific city. use after obtaining a valid city name when current aqi and pollutant levels are needed.

Action Parameters

city

stringRequired

limit

integerDefaults to 1

Action Response

data

objectRequired

error

string

successful

booleanRequired

AMBEE_GET_AIR_QUALITY_BY_COUNTRY_CODE

Tool Name: Get Air Quality by Country Code

Description

Tool to retrieve real-time air quality data for a specific country using a 3-letter iso code. use after acquiring the country code and when you want a national overview of air quality.

Action Parameters

countryCode

stringRequired

limit

integerDefaults to 1

Action Response

data

objectRequired

error

string

successful

booleanRequired

AMBEE_GET_AIR_QUALITY_BY_LAT_LNG

Tool Name: Get Air Quality by Latitude and Longitude

Description

Tool to retrieve real-time air quality data for a specific latitude and longitude. use when you need hyper-local air quality readings for given coordinates.

Action Parameters

lat

numberRequired

lng

numberRequired

Action Response

data

arrayRequired

error

string

message

string

successful

booleanRequired

AMBEE_GET_AIR_QUALITY_BY_POSTAL_CODE

Tool Name: Get Air Quality by Postal Code

Description

Tool to retrieve real-time air quality data for a specific postal code and country. use when you need hyper-local air quality insights by postal code.

Action Parameters

countryCode

stringRequired

postalCode

stringRequired

Action Response

data

arrayRequired

error

string

message

stringRequired

successful

booleanRequired

AMBEE_GET_AIR_QUALITY_FORECAST_BY_LAT_LNG

Tool Name: Get Air Quality Forecast by Latitude and Longitude

Description

Tool to retrieve air quality forecast for a specific latitude and longitude. use when you need predicted air quality data up to 48 hours in advance based on geographic coordinates.

Action Parameters

lat

numberRequired

lng

numberRequired

Action Response

data

arrayRequired

error

string

message

string

successful

booleanRequired

AMBEE_GET_DISASTERS_BY_CONTINENT_LATEST

Tool Name: Retrieve latest natural disasters by continent

Description

Tool to retrieve latest natural disaster data for a specific continent. use when you need up-to-date disaster information by continent code.

Action Parameters

continent

stringRequired

eventType

string

limit

integerDefaults to 10

page

integerDefaults to 1

Action Response

data

objectRequired

error

string

successful

booleanRequired

AMBEE_GET_ELEVATION_BY_LAT_LNG

Tool Name: Get Elevation by Latitude and Longitude

Description

Tool to retrieve elevation statistics (min, max, mean) for a specific latitude and longitude. use when you need geospatial elevation data for a location within north america.

Action Parameters

lat

numberRequired

lng

numberRequired

Action Response

data

objectRequired

error

string

status

stringRequired

successful

booleanRequired

AMBEE_GET_ELEVATION_BY_PLACE

Tool Name: Get Elevation by Place

Description

Tool to retrieve elevation or altitude data for a specific location by place name. use when you have a textual place name and need its elevation in meters.

Action Parameters

place

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

AMBEE_GET_ILI_FORECAST_BY_LAT_LNG

Tool Name: Get ILI Forecast by Latitude and Longitude

Description

Tool to retrieve 30-day forecast of influenza-like illness (ili) risk using latitude and longitude. use when you need daily ili risk levels for a specific location, optionally including pollen and weather details.

Action Parameters

details

boolean

lat

numberRequired

lng

numberRequired

Action Response

data

arrayRequired

error

string

message

string

successful

booleanRequired

AMBEE_GET_WILDFIRE_BY_LAT_LNG

Tool Name: Get Wildfire Data by Latitude and Longitude

Description

Tool to retrieve real-time wildfire data for a specific latitude and longitude. use when detailed geospatial wildfire monitoring is required.

Action Parameters

lat

numberRequired

lng

numberRequired

type

string

Action Response

data

arrayRequired

error

string

httpCode

integer

successful

booleanRequired

successfull

booleanRequired

AMBEE_GET_WILDFIRE_BY_PLACE

Tool Name: Get Wildfire Data by Place

Description

Tool to retrieve real-time wildfire data for a specific place. use after confirming the place name.

Action Parameters

place

stringRequired

type

string

Action Response

data

objectRequired

error

string

httpCode

integer

successful

booleanRequired

successfull

booleanRequired

AMBEE_GET_WILDFIRE_RISK_FORECAST_BY_PLACE

Tool Name: Get Wildfire Risk Forecast by Place

Description

Tool to retrieve wildfire risk forecast for a specific place. use when you need weekly wildfire risk predictions for a location over the next four weeks.

Action Parameters

place

stringRequired

Action Response

data

arrayRequired

error

string

message

stringRequired

successful

booleanRequired