> For the complete documentation index, see [llms.txt](https://docs.toolregistry.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.toolregistry.ai/concepts/integrations/agent-instructions-for-integrations.md).

# Agent Instructions for Integrations

Declarative, per-integration guidance that tells the agent **when** to call this integration and **how** to use it safely. Keep it outcome‑focused, scope‑limited, and explicit about side effects.

### Why this matters

Agents discover tools dynamically. Clear instructions reduce hallucinated calls, prevent unsafe writes, and keep cost/performance predictable.

<figure><img src="/files/QJAvLLVfbs0g378HgqGR" alt=""><figcaption></figcaption></figure>

### How to write good instructions

* **Be declarative**: describe *what to accomplish* and *when to use this integration*, not step-by-step mechanics.
* **Constrain scope**: enumerate allowed capabilities and explicitly forbid risky actions.
* **Name preconditions**: required fields, auth, scopes, and object existence checks.
* **Define side effects**: what gets written/updated; link to approvals if destructive.