agent-foundation/README.md

# Agent Foundation

Java Spring Boot service for Enterprise WeChat callbacks and internal APIs.

## Core API
- POST `/v1/chat/completions`
- GET `/v1/healthz`

## WeCom Callback
- Callback URL: `/v1/integrations/wecom/callback`
- Verifies Enterprise WeChat callback signatures
- Decrypts encrypted callback payloads when safe mode is enabled
- Deduplicates text messages
- Sends Enterprise WeChat text content to the configured Coze workflow
- Sends the Coze workflow reply back to the same Enterprise WeChat user

The old internal agent orchestration code has been removed. Intelligent
responses now go through Coze while keeping this callback entrypoint.

## Coze Workflows
Configure multiple Coze workflow agents under `foundation.coze.workflows`.
Business code calls them by key, for example `wecom-default`.

```yaml
foundation:
  coze:
    default-workflow: wecom-default
    workflows:
      wecom-default:
        workflow-id: "7661923520095862811"
        app-id: "7661851003527954473"
        parameters: {}
```

### Required env vars
- `DEEPSEEK_API_KEY`
- `WECOM_CORP_ID`
- `WECOM_AGENT_ID`
- `WECOM_SECRET`
- `WECOM_TOKEN`
- `COZE_API_KEY`

### WeCom backend settings
1. Create a WeCom self-built app.
2. Enable message receive API and set callback URL to:
   - `https://your-domain/v1/integrations/wecom/callback`
3. Set callback Token equal to `WECOM_TOKEN`.
4. Make sure app has send-message permission to internal users.

## Run
1. Set env vars.
2. Start app from IDE or `mvn spring-boot:run`.