> ## Documentation Index
> Fetch the complete documentation index at: https://hercules.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent integrations and skills

> Give your Hercules Agent built-in tools like web search, connect the apps you already use, and share reusable skills across Agents.

<Note>
  Agents is in private beta, so things may change. If you hit a problem, tell us via [Support &
  feedback](/docs/company/contact).
</Note>

Integrations are what let an Agent do things, not only write text. It can search the web, keep files between runs, or reach into an app you use like Slack or Stripe. Skills are instructions you write once and reuse across Agents.

Go to **Agents** → open an Agent → **Build** → **Integrations**. Skills live on **Build** → **Files & skills**.

<div className="screenshot ocean">
  <img src="https://mintcdn.com/zeus-0f6dadbf/AUzCpLx0wjCzKFM0/images/agents/integrations-main.png?fit=max&auto=format&n=AUzCpLx0wjCzKFM0&q=85&s=5132a41339364246bd0d8a0f3cd02d75" alt="Agent integrations page listing the Web, File workspace, and Subagents toolkits plus a connected GitHub service" width="1842" height="698" data-path="images/agents/integrations-main.png" />
</div>

### What built-in tools can I turn on?

Each one is a toolkit (a group of tools that switch on together), so you don't have to pick tools one by one.

| Toolkit            | What it does                                                         |
| ------------------ | -------------------------------------------------------------------- |
| **Web**            | Search the web and read the full pages it finds                      |
| **File workspace** | Read and write files that stick around between runs                  |
| **Subagents**      | Hand part of a task to a helper Agent that works with the same tools |

<Note>
  Subagents get whatever tools the Agent already has, so this one is only worth turning on alongside
  others.
</Note>

### How do I add an integration?

Click **Add integration** to open the catalog. It has three kinds of entry:

* **Built-in tools**: the ones in the table above, with no setup needed
* **Apps**: things like Slack or Stripe, which you connect once and then use
* **Custom**: services you added yourself

Filter by **Popular**, **All**, **Enabled**, **Made by Hercules**, or by category. Searching looks beyond **Popular** automatically, so you can find anything by name.

### Can I control which parts of an app the Agent uses?

Yes. Open a connected app in the sidebar to see its tools. Switch between **All tools** and **Enabled tools only**, and turn individual tools on or off.

### What is a skill?

A skill is a set of instructions saved in your Organization's skill library and shared across Agents. Write a process once instead of copying it into every Agent.

Add one on **Build** → **Files & skills** → **Add a skill**.

### What if the app I need is missing?

Click **Suggest an integration** in the catalog and tell us which one you need.

### Additional FAQ

<AccordionGroup>
  <Accordion title="Do these changes go live straight away?">
    No. They're part of the Agent, so they save into a draft and go live when you **Publish**. See
    [Versions](/docs/agents/versions).
  </Accordion>

  <Accordion title="How many integrations should I add?">
    Only the ones the Agent needs. Every extra tool is one more thing it has to choose between, and
    more choices usually means worse decisions.
  </Accordion>

  <Accordion title="Can I limit what an integration is allowed to do?">
    Yes, with [Guardrails](/docs/agents/guardrails). A guardrail set to **Integration input** is checked
    before the Agent uses an integration, and can stop it. You can point it at specific integrations
    or apply it to all of them.
  </Accordion>

  <Accordion title="Do integrations cost credits?">
    Using a tool during a run adds to what that run costs, and shows up in the run's cost on
    [Analytics](/docs/agents/analytics). See [Costs and limits](/docs/agents/costs-and-limits).
  </Accordion>

  <Accordion title="Are these the same as Chat Connectors?">
    Same apps, connected for a different reason. [Chat Connectors](/docs/ai/chat-connectors) let the
    Hercules App Builder Agent reach your tools while you build an app. Agent integrations let your
    own Agent reach them while it runs.
  </Accordion>

  <Accordion title="What happened to Read PDF, Image search, and Image generation?">
    They were retired. All three were App Builder tools that needed a chat attachment, or saved things
    nowhere else in an Agent run could read. If an Agent still lists one, it's ignored. Older
    [versions](/docs/agents/versions) still show it in their history.
  </Accordion>
</AccordionGroup>