53 lines
1.5 KiB
Markdown
53 lines
1.5 KiB
Markdown
# 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`.
|