Skip to main content
Tools are actions Athena can use in a session, such as editing a document or querying data. A toolkit groups related tools so you can enable them together. Use toolkits when your task needs capabilities beyond reading an asset.

How to turn on a toolkit for a session

  1. Open Tools
  2. Find the toolkit
  3. Turn it on
  4. Check the count
  5. Ask again

How to give Athena the right toolkit

  1. Check what is on
  2. Find the toolkit
  3. Turn it on
  4. Ask for the document
  5. Open the selector options
  6. Choose Ask and wait
  7. Review the request
  8. Compare the two modes

Choose tools for a session

  1. Select the Tools button in the chat composer. Its tooltip is titled Agent Tools and its badge shows how many tools are on.
  2. Search for a toolkit and read its description.
  3. Enable the toolkit to enable its related tools together. You can also select individual tools.
  4. Check the enabled tool count, then send your request.
The menu shows toolkits available to your agent. It hides some toolkits and can omit small groups whose tools are already covered by other groups. It is not a complete inventory. Use the Toolkit reference to compare customer toolkits, including Olympus Drive for workspace files.

Let Athena select toolkits

Session Sandbox and Toolkit Selector start enabled in a new Athena session. Other agent configurations can differ. Toolkit Selector lets Athena discover, enable, and disable toolkits during a run. Toolkit Selector starts in auto mode, so Athena normally switches on the toolkits a request needs without asking. Use these steps to change that.
  1. Mention Toolkit Selector in your prompt.
  2. Hover over the mention to open its options.
  3. Choose Ask and wait to review changes first, or Auto-select and proceed to let Athena change toolkits and continue.
  4. In Ask and wait, choose Pause until approval if Athena must wait for your decision.

Good to know

Turning off a toolkit does not remove a tool that another enabled toolkit or an individual selection still grants. Permanently enabled tools also remain available. In Athena sessions, read_asset remains available even when you disable the related toolkit. Reading still respects your asset permissions. Enabling a toolkit does not grant access to another person’s assets or connected accounts. Your agent’s configuration, workspace capabilities, and connections can limit what appears in the menu.
Toolkit settings with toggles for available tools