Akuity Intelligence Capabilities

Akuity Intelligence can interact with Argo CD, Kargo, Kubernetes, and many third-party systems through tools. You can request the use of these tools in conversations with AI agents. These tools can also be used in runbooks. The following are all the tools available in Akuity Intelligence:

• Create Git Repository Issue - Creates a new issue in a Git repository.
• Create Git Repository Pull Request - Create a pull request for a Git repository.
• Delete Kubernetes resource - Deletes the specified Kubernetes resource.
• Disable Argo CD app auto-sync - Disables the auto-sync feature of the Argo CD application.
• Edit Slack message - Updates existing message with a new text.
• Get Argo CD app project - Returns the JSON serialized project the Argo CD application belongs to.
• Get Argo CD application - Retrieves Argo CD application information.
• Get Argo CD application events - Returns the Argo CD K8S Events and Akuity Timeline Events.
• Get Argo CD application tree - Retrieves Argo CD application resource tree.
• Get Argo CD instance settings - Returns the settings of the Argo CD instance.
• Get Argo CD instance version info - Returns the version information of the Argo CD instance and configured tools.
• Get Argo CD managed resource diff - Returns the difference between the current state and the desired state of a resource managed by an Argo CD application.
• Get Git Repository Issue Comments - Returns a paginated list of comments for a specific issue in a Git repository.
• Get Git Repository Issue Details - Returns details of a single issue in a Git repository.
• Get Kargo project - Retrieves detailed information about a specific Kargo project including its metadata, status, and statistics about warehouses and stages.
• Get Kargo project tree - Retrieves the hierarchical structure of Kargo resources in a project
• Get Kargo promotion - Retrieves detailed information about a specific Kargo Promotion including its status, freight details, and progress information.
• Get Kargo stage - Retrieves detailed information about a specific Kargo Stage including its spec with requested freight configuration and promotion rules.
• Get Kargo warehouse - Retrieves detailed information about a specific Kargo Warehouse including its configuration for watching artifact sources.
• Get Kubernetes Namespace resources tree - Fetches the resource tree of a specified Kubernetes Namespace
• Get Kubernetes resource - Retrieves JSON serialized kubernetes resource.
• Get Kubernetes version - Returns K8S and akuity agent version.
• Get Kubernetes workload logs - Fetch logs from a Kubernetes workloads.
• Get Runbooks - Retrieves runbook details by their names. Returns complete runbook content with General, Symptoms, Root cause, and Solution sections.
• Get Slack channels - Returns list of channels where messages can be sent.
• Get conversation link - Returns a link to current conversation.
• Get detailed code changes for specific files from the commits - Get actual code patches for specific files that AI has identified as important for analysis
• Get incidents - Retrieves JSON-serialized incidents for the given context. If the user is asking for a specific time range, the current time is 2026-04-02T19:52:08Z.
• Get incidents count - Retrieves total number of incidents for the given context. If the user is asking for a specific time range, the current time is 2026-04-02T19:52:08Z.
• Get overview of the commits stats and changed files - Get detailed code changes and file list for specific git commits (from freight commits or image OCI annotations)
• Get overview of the promotion changes - Gather all promotion changes including git commits, images (with git info from OCI annotations), charts, and metadata for AI analysis
• Get release notes for GitHub releases - Get release notes for GitHub releases between semantic versions (v1.0.0, v1.2.3) or git commits. Supports image version detection and automatic semantic version range analysis for comprehensive release notes.
• List Argo CD applications - Retrieves a list of all Argo CD applications.
• List Container Resources - Get list of container resources managed by given instance, cluster or namespace
• List Deprecated APIs - Get list of k8s deprecated apis managed by given instance or cluster
• List Git Repository Branches - Returns a paginated list of branches in the git repository, with optional filtering by branch name.
• List Git Repository Files - Returns list of files (optionally with content) in the git repository.
• List Git Repository Issues - Returns a paginated list of issues for a Git repository. Supports filtering by state (open/closed/all), labels, assignee, and text search.
• List Images - Get list images managed by given instance or cluster
• List K8s resources - Get list of k8s resources managed by given instance, cluster or namespace
• List Kargo freight - Queries for Freight in a Kargo project. Freight represents a collection of artifacts (container images, Helm charts, Git commits) that can be promoted through stages. You can filter by stage.
• List Kargo promotions - Retrieves a list of Promotions in a Kargo project. Promotions represent the movement of Freight from one Stage to another. You can optionally filter by a specific stage.
• List Kargo stages - Retrieves a list of all Stages in a Kargo project. Stages represent environments in the delivery pipeline and define how freight is promoted through them.
• List Kargo warehouses - Retrieves a list of all Warehouses in a Kargo project. Warehouses watch for new artifacts (container images, Helm charts, Git commits) and produce Freight.
• List Stuck In Deletion Resources - Get list of k8s resources stuck in deletion managed by given instance, cluster or namespace
• Patch Kubernetes resource - Applies provided json serialized strategic merged patch to the given resource.
• Post Git Repository Issue Comment - Posts a comment on an existing issue in a Git repository.
• Promote freight to stage - Promotes specified freight to the target Kargo stage
• Refresh Kargo warehouse - Triggers a refresh of a specific Kargo Warehouse to check for new artifacts. This forces the warehouse to scan its configured sources (Git repositories, container registries, Helm repositories) for new artifacts and produce new Freight.
• Resolve Incident - Marks incident resolved with the given resolution description.
• Run refresh action on application - The function refreshs the application.
• Run rollback action on application - The function rollbacks the application.
• Run sync action on application - The function syncs the application.
• Search Documentation - Search the documentation for relevant information. Always include the conversation context to help refine the search.
• Sends a Slack message - Sends a slack message.
• Store Runbook - Stores a runbook to the ArgoCD instance configuration, the runbook will be used to automate the handling of future incidents
• Update Git Repository Files - Commit files to the git repository. It creates a commit with the provided commit message. If the file doesn't exist, it will be created.
• Update Incident Root Cause - Updates incident root cause.
• Update Incident Summary - Updates incident summary.
• Update promotion analysis summary - Updates promotion analysis with summary, risk level, and completion status.
• Verify Kubernetes resource patch - Verifies if the provided json serialized strategic merged patch is valid.

Tool Policies

Tool Policies provide a critical security layer that gives you fine-grained control over the actions Akuity Intelligence can perform. By default, Akuity Intelligence is pre-configured with policies that allow the Akuity Agents to operate with reasonable independence, while still requiring human approval for sensitive or potentially risky actions. As an example the Akuity Agents are permitted to perform read-only actions, modify resources, and delete pods. The policies page allows you to customize this behavior, enabling you to define specific rules for when and how the Akuity Agents can execute function calls.

To configure tool policies:

• Navigate to Organization → Settings.
• From the left-hand menu, select the AI tab.
• The Tool Policies section allows you to view, create, and manage your policies.

Creating a Policy for User Approval

A policy is composed of a Target (the action being taken), the Contexts (where the action applies), and an Action (the required approval level).
To configure a rule that requires user approval for a specific operation, follow these steps:

• Click Add to create a new policy row.
• Define the Target of the operation you want to control:
  • Name: The name of the function the AI is attempting to call. You can use * as a wildcard to apply the policy to any function.
  • Arguments: A specific condition to match against the function's arguments. This allows for highly specific rules. For example, the expression args.resourceID.kind == 'Deployment' targets any action where the resource being acted upon is a Kubernetes Deployment.
• Define the Contexts to limit the policy's scope. You can restrict the rule to specific:
  • Clusters
  • K8s Namespaces
  • Argo CD Applications
  • Kargo Projects
  • Runbooks
• Set the final Action to Approve or Require Approval based on your needs.

For instance, with the following example, whenever the On-Call Agent attempts to execute a function that performs a write operation(e.g., update a Deployment), it will pause and explicitly ask for user confirmation before proceeding, ensuring a human is always in the loop for critical operations.

Multiple Tool Policies

You can configure multiple policies. The Akuity Platform evaluates them in order, with the last matching policy taking precedence.

For example, you could set a policy requiring approval for all tools, along with another that auto-approves the ArgoCD application refresh action. In this case, all tools would require approval except the refresh action.