chore(docs): bring AMP doc refresh from release/v1.0.0 into main (#3637)

* WIP: v1 docs (#3626) (cherry picked from commit d46e20fa09bcd2f5916282f5553ddeb7183bd92c) * docs: parity for all translations * docs: full name of acronym AMP * docs: fix lingering unused code * docs: expand contextual options in docs.json * docs: add contextual action to request feature on GitHub * chore: tidy docs formatting
2025-12-16 04:18:35 +00:00 · 2025-10-02 11:36:04 -04:00
parent f47e0c82c4
commit bf9e0423f2
242 changed files with 8999 additions and 3637 deletions
--- a/docs/en/enterprise/features/tools-and-integrations.mdx
+++ b/docs/en/enterprise/features/tools-and-integrations.mdx
@@ -0,0 +1,249 @@
+---
+title: Tools & Integrations
+description: "Connect external apps and manage internal tools your agents can use."
+icon: "wrench"
+mode: "wide"
+---
+
+## Overview
+
+Tools & Integrations is the central hub for connecting third‑party apps and managing internal tools that your agents can use at runtime.
+
+<Frame>
+  ![Tools & Integrations Overview](/images/enterprise/crew_connectors.png)
+</Frame>
+
+## Explore
+
+<Tabs>
+  <Tab title="Integrations" icon="plug">
+
+  ## Agent Apps (Integrations)
+
+  Connect enterprise‑grade applications (e.g., Gmail, Google Drive, HubSpot, Slack) via OAuth to enable agent actions.
+
+  <Steps>
+    <Step title="Connect">
+      Click <b>Connect</b> on an app and complete OAuth.
+    </Step>
+    <Step title="Configure">
+      Optionally adjust scopes, triggers, and action availability.
+    </Step>
+    <Step title="Use in Agents">
+      Connected services become available as tools for your agents.
+    </Step>
+  </Steps>
+
+  <Frame>
+    ![Integrations Grid](/images/enterprise/agent-apps.png)
+  </Frame>
+
+  ### Connect your Account
+
+  1. Go to <Link href="https://app.crewai.com/crewai_plus/connectors">Integrations</Link>
+  2. Click <b>Connect</b> on the desired service
+  3. Complete the OAuth flow and grant scopes
+  4. Copy your Enterprise Token from the <b>Integration</b> tab
+
+  <Frame>
+    ![Enterprise Token](/images/enterprise/enterprise_action_auth_token.png)
+  </Frame>
+
+  ### Install Integration Tools
+
+  To use the integrations locally, you need to install the latest `crewai-tools` package.
+
+  ```bash
+  uv add crewai-tools
+  ```
+
+  ### Usage Example
+
+  <Tip>
+    All services you have authenticated will be available as tools. Add `CrewaiEnterpriseTools` to your agent and you’re set.
+  </Tip>
+
+  ```python
+  from crewai import Agent, Task, Crew
+  from crewai_tools import CrewaiEnterpriseTools
+
+  # Get enterprise tools (Gmail tool will be included)
+  enterprise_tools = CrewaiEnterpriseTools(
+      enterprise_token="your_enterprise_token"
+  )
+  # print the tools
+  print(enterprise_tools)
+
+  # Create an agent with Gmail capabilities
+  email_agent = Agent(
+      role="Email Manager",
+      goal="Manage and organize email communications",
+      backstory="An AI assistant specialized in email management and communication.",
+      tools=enterprise_tools
+  )
+
+  # Task to send an email
+  email_task = Task(
+      description="Draft and send a follow-up email to john@example.com about the project update",
+      agent=email_agent,
+      expected_output="Confirmation that email was sent successfully"
+  )
+
+  # Run the task
+  crew = Crew(
+      agents=[email_agent],
+      tasks=[email_task]
+  )
+
+  # Run the crew
+  crew.kickoff()
+  ```
+
+  ### Filtering Tools
+
+  ```python
+  from crewai_tools import CrewaiEnterpriseTools
+
+  enterprise_tools = CrewaiEnterpriseTools(
+      actions_list=["gmail_find_email"]  # only gmail_find_email tool will be available
+  )
+
+
+  gmail_tool = enterprise_tools["gmail_find_email"]
+
+
+  gmail_agent = Agent(
+      role="Gmail Manager",
+      goal="Manage gmail communications and notifications",
+      backstory="An AI assistant that helps coordinate gmail communications.",
+      tools=[gmail_tool]
+  )
+
+  notification_task = Task(
+      description="Find the email from john@example.com",
+      agent=gmail_agent,
+      expected_output="Email found from john@example.com"
+  )
+
+  crew = Crew(
+      agents=[gmail_agent],
+      tasks=[notification_task]
+  )
+  ```
+
+  On a deployed crew, you can specify which actions are available for each integration from the service settings page.
+
+  <Frame>
+    ![Filter Actions](/images/enterprise/filtering_enterprise_action_tools.png)
+  </Frame>
+
+  ### Scoped Deployments (multi‑user orgs)
+
+  You can scope each integration to a specific user. For example, a crew that connects to Google can use a specific user’s Gmail account.
+
+  <Tip>
+    Useful when different teams/users must keep data access separated.
+  </Tip>
+
+  Use the `user_bearer_token` to scope authentication to the requesting user. If the user isn’t logged in, the crew won’t use connected integrations. Otherwise it falls back to the default bearer token configured for the deployment.
+
+  <Frame>
+    ![User Bearer Token](/images/enterprise/user_bearer_token.png)
+  </Frame>
+
+  <div id="catalog"></div>
+  ### Catalog
+
+  #### Communication & Collaboration
+  - Gmail — Manage emails and drafts
+  - Slack — Workspace notifications and alerts
+  - Microsoft — Office 365 and Teams integration
+
+  #### Project Management
+  - Jira — Issue tracking and project management
+  - ClickUp — Task and productivity management
+  - Asana — Team task and project coordination
+  - Notion — Page and database management
+  - Linear — Software project and bug tracking
+  - GitHub — Repository and issue management
+
+  #### Customer Relationship Management
+  - Salesforce — CRM account and opportunity management
+  - HubSpot — Sales pipeline and contact management
+  - Zendesk — Customer support ticket management
+
+  #### Business & Finance
+  - Stripe — Payment processing and customer management
+  - Shopify — E‑commerce store and product management
+
+  #### Productivity & Storage
+  - Google Sheets — Spreadsheet data synchronization
+  - Google Calendar — Event and schedule management
+  - Box — File storage and document management
+
+  …and more to come!
+
+  </Tab>
+  <Tab title="Internal Tools" icon="toolbox">
+
+  ## Internal Tools
+
+  Create custom tools locally, publish them on CrewAI AMP Tool Repository and use them in your agents.
+
+  <Tip>
+  Before running the commands below, make sure you log in to your CrewAI AMP account by running this command:
+    ```bash
+    crewai login
+    ```
+  </Tip>
+
+  <Frame>
+    ![Internal Tool Detail](/images/enterprise/tools-integrations-internal.png)
+  </Frame>
+
+  <Steps>
+    <Step title="Create">
+      Create a new tool locally.
+      ```bash
+      crewai tool create your-tool
+      ```
+    </Step>
+    <Step title="Publish">
+      Publish the tool to the CrewAI AMP Tool Repository.
+      ```bash
+      crewai tool publish
+      ```
+    </Step>
+    <Step title="Install">
+      Install the tool from the CrewAI AMP Tool Repository.
+      ```bash
+      crewai tool install your-tool
+      ```
+    </Step>
+  </Steps>
+
+  Manage:
+
+  - Name and description
+  - Visibility (Private / Public)
+  - Required environment variables
+  - Version history and downloads
+  - Team and role access
+
+  <Frame>
+    ![Internal Tool Detail](/images/enterprise/tool-configs.png)
+  </Frame>
+
+  </Tab>
+</Tabs>
+
+## Related
+
+<CardGroup cols={2}>
+  <Card title="Tool Repository" href="/en/enterprise/features/tool-repository" icon="toolbox">
+    Create, publish, and version custom tools for your organization.
+  </Card>
+  <Card title="Webhook Automation" href="/en/enterprise/guides/webhook-automation" icon="bolt">
+    Automate workflows and integrate with external platforms and services.
+  </Card>
+</CardGroup>