Attribution integrations for AI Cost Management

OpenAPI Specifications
Minimum Version
AI Gateway - 2.3
Incompatible with
on-prem

Attribution integrations are the AI tools and platforms that route requests through your AI Gateway and supply the tags AI Cost Management uses to attribute spend.

Some of these integrations send standard tags automatically through their native headers. For others, you need to configure the tools to send ai-cost- prefixed headers to add the tags you want.

Tag capture requires each AI Gateway data plane to run with KONG_CUSTOM_PLUGIN_STREAMING_ENABLED=on. Data planes without this flag don’t capture ai-cost- headers or native integration headers. See Set up header-based attribution for details.

Integrations

The following integrations are available in AI Cost Management. Clicking a tile opens the integration in your Konnect org, where you can follow the setup instructions.

Coding agents

Tools developers run in a terminal or an editor.

CI and source control

Jobs that run an AI tool on a change, a pull request, or a schedule.

Chat apps

Bots you build for your team’s chat.

Issue trackers

Bots and agents that work on issues and incidents.

Agent frameworks

Libraries your applications build agents with.

Other AI gateways

Clients that still send another AI gateway’s tag headers.

Your applications

Your own services that call models through your gateway.

Tag reference

The following table lists the tags each integration sends automatically and those you can add with ai-cost-KEY_NAME headers.

Integration

Sends automatically

Add with ai-cost-KEY_NAME headers

Claude Code
  • agent-session
  • agent-id
  • agent-parent
  • agent-request-kind
  • agent-type
  • scm-provider
  • scm-repository
  • scm-branch
Codex CLI
  • agent-session
  • agent-request-kind
  • scm-repository
  • scm-provider
  • scm-commit
  • agent-id
  • agent-parent
  • agent-type
  • scm-branch
  • project
OpenCode
  • agent-session
  • agent-id
  • agent-parent
  • scm-provider
  • scm-repository
  • scm-branch
Gemini CLI None
  • scm-provider
  • scm-repository
  • scm-branch
GitHub Copilot in VS Code
  • agent-request-kind
  • project
Cline None
  • project
Aider None
  • project
  • scm-provider
  • scm-repository
GitHub Actions None
  • scm-provider
  • scm-repository
  • scm-branch
  • scm-pull-request
  • scm-commit
  • ci-provider
  • ci-pipeline
  • ci-run
GitLab CI None
  • scm-provider
  • scm-repository
  • scm-branch
  • scm-pull-request
  • scm-commit
  • ci-provider
  • ci-pipeline
  • ci-run
Jenkins None
  • scm-provider
  • scm-repository
  • scm-branch
  • scm-pull-request
  • scm-commit
  • ci-provider
  • ci-pipeline
  • ci-run
Buildkite None
  • scm-provider
  • scm-repository
  • scm-branch
  • scm-pull-request
  • scm-commit
  • ci-provider
  • ci-pipeline
  • ci-run
CircleCI None
  • scm-provider
  • scm-repository
  • scm-branch
  • scm-pull-request
  • scm-commit
  • ci-provider
  • ci-pipeline
  • ci-run
Slack None
  • chat-provider
  • chat-organization
  • chat-workspace
  • chat-channel
  • chat-channel-id
  • chat-channel-type
  • chat-trigger
  • chat-command
  • agent-name
  • agent-session
  • workflow-run
Microsoft Teams None
  • chat-provider
  • chat-workspace
  • chat-channel-id
Discord None
  • chat-provider
  • chat-workspace
  • chat-channel-id
  • agent-session
Jira None
  • ticket
  • project
Linear None
  • ticket
  • project
PagerDuty None
  • ticket
GitHub and GitLab issues None
  • scm-issue
  • scm-repository
OpenAI Agents SDK None
  • workflow-name
  • workflow-run
  • agent-session
LangChain and LangGraph None
  • workflow-name
  • workflow-run
  • agent-session
CrewAI None
  • workflow-name
  • workflow-run
LlamaIndex Workflows None
  • workflow-name
  • workflow-run
n8n None
  • workflow-name
  • workflow-run
  • agent-session
Vercel AI SDK None
  • workflow-name
Helicone
  • agent-session (from Helicone-Session-Id)
  • Any Helicone-Property-<Name> header becomes a tag named <name>.
None
Portkey Each key in the x-portkey-metadata JSON object becomes a tag of the same name. None
Cloudflare AI Gateway Each key in the cf-aig-metadata JSON object becomes a tag of the same name. None
Your own code None
  • project
  • environment
  • use-case
  • feature
  • customer-account

Help us make these docs great!

Kong Developer docs are open source. If you find these useful and want to make them better, contribute today!