# setup-agent-scanner

Creates a scanner configuration to discover AI agents from external platforms like AWS Bedrock, Microsoft Copilot, or Google Vertex AI. Use when setting up agent discovery, configuring a new scanner, connecting to cloud AI platforms, or importing agents into Anypoint Exchange.

- **APIs:** [access-management](https://dev-portal.mulesoft.com/apis/access-management.md), [agent-scanner-configuration-service](https://dev-portal.mulesoft.com/apis/agent-scanner-configuration-service.md)- **Skill Source:** [SKILL.md](https://dev-portal.mulesoft.com/skills/setup-agent-scanner/SKILL.md)

## Steps
### Step 1: Step 1: Get Available Target Systems
**API:** `urn:api:agent-scanner-configuration-service`**Operation:** `getTargetSystems`
**Inputs:**
- `organizationId` — Your organization's Business Group GUID

**Outputs:**
- `targetSystemId` (`$[*].id`) — The target system ID to use when creating a connection
- `targetSystemType` (`$[*].type`) — The target system type (e.g., bedrock, mscopilot, vertex)

### Step 2: Step 2: Create a Connection
**API:** `urn:api:agent-scanner-configuration-service`**Operation:** `createConnection`
**Inputs:**
- `organizationId` — Same organization ID as Step 1
- `requestBody` — Connection details including:
- name: Display name for the connection
- targetSystemId: ID from Step 1
- authScheme: Authentication scheme (e.g., "accessKey", "oauth2")
- authParameters: JSON with credentials (varies by platform)


**Outputs:**
- `connectionId` (`$`) — The UUID of the created connection

### Step 3: Step 3: Create Scanner Configuration
**API:** `urn:api:agent-scanner-configuration-service`**Operation:** `createScanConfigurations`
**Inputs:**
- `organizationId` — Same organization ID as previous steps
- `requestBody` — Scanner configuration including:
- name: Display name for the scanner
- schedule: JSON schedule configuration
- runPolicy: JSON run policy (can be empty object)
- connection: Object with connection details
- notificationEnabled: Whether to send email notifications


**Outputs:**
- `scannerConfigurationId` (`$.id`) — The UUID of the created scanner configuration
- `scannerState` (`$.state`) — The current state of the scanner (e.g., SCHEDULED, STOPPED)