agent-foundation/README.md

Agent Foundation

Java Spring Boot base platform for multiple enterprise agents (CRM assistant, knowledge-base assistant, customer service assistant).

Core API

• POST /v1/chat/completions
• GET /v1/healthz

WeCom CRM Bot Integration

• Callback URL: /v1/integrations/wecom/callback
• Receive enterprise WeCom text messages and route to crm-assistant
• Send the model response back to the same WeCom user

Required env vars

• DEEPSEEK_API_KEY
• WECOM_CORP_ID
• WECOM_AGENT_ID
• WECOM_SECRET
• WECOM_TOKEN

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.