Skip to main content

Custom Agents

A page for configuring how the AI assistant behaves through agents, skills, integrations, and tools.

Custom Agents & Skills
Admin only

This page is available to admins only (the Cognito admins group or the SSM admin allowlist). Non-admin users see an access-denied screen.

Features​

New Agent​

Create a new agent that defines how the assistant responds.

  • name: agent name (kebab-case)
  • description: agent description
  • persona: system prompt (the agent's voice and perspective)
  • gateway: area of focus — network, container, iac, data, security, monitoring, cost, ops
  • routing keywords: keywords that route questions to this agent (comma-separated)
  • agent type: lifecycle role — generic, on_demand, triage, rca, mitigation, evaluation

New Skill​

Create a reusable skill shared across agents.

  • name / description: skill name and description
  • instructions: how the skill should be performed
  • agent types (targeting): which agent types the skill applies to (multi-select checkboxes)

Agents / Skills lists​

  • New agents and skills start Disabled and are toggled on in the lists below.
  • Built-in items show a built-in label and are not toggleable.

Data-source connectors​

Connect read-only observability connectors (Prometheus, Loki, Tempo, Mimir, ClickHouse).

  • Enter the endpoint and credentials to connect. Credentials are stored server-side and are never shown back.
  • Use Refresh schema to cache the schema so the assistant can query that data source.

Advanced​

The Advanced — register custom integration section registers custom egress/ingress integrations.

Agent Space​

Choose which agents, skills, and integrations are active for the account, plus a tool allowlist, then save. The version increments on each save.

How to use​

  1. Click AI Operations > Custom Agents in the sidebar
  2. In New Agent, enter name, description, and persona, pick a gateway and agent type, add routing keywords, and create
  3. Optionally create a skill in New Skill and select the agent types it applies to
  4. Toggle the new items on in the Agents / Skills lists below
  5. In Data-source connectors, enter an endpoint and credentials to connect, then Refresh schema to cache it
  6. In Agent Space, choose the active items and tool allowlist, then click Save Agent Space
They start disabled

New agents and skills are not enabled automatically. You must toggle them on in the lists and include them in the Agent Space, then save, for them to take effect in the assistant.

Credentials are not shown back

Connector credentials are not displayed after saving. To change them, re-enter the values and click Update.