77 lines
2.9 KiB
Markdown
77 lines
2.9 KiB
Markdown
# DobotAI Platform
|
|
|
|
DobotAI is the external enterprise integration layer for official WeKnora. It does not import WeKnora packages, modify WeKnora source, or access the WeKnora database.
|
|
|
|
Current milestone: channel-bound Agent QA core.
|
|
|
|
Implemented:
|
|
|
|
- official `POST /api/v1/sessions` adapter;
|
|
- official `POST /api/v1/agent-chat/:session_id` adapter;
|
|
- fail-closed SSE parsing for `references`, `answer`, `error`, and terminal `done`;
|
|
- per-channel/per-conversation Agent binding;
|
|
- long-lived direct-user sessions;
|
|
- shared-group sessions, with optional group+user policy;
|
|
- external-message idempotency;
|
|
- independent PostgreSQL session/turn storage;
|
|
- authenticated internal `POST /v1/qa` ingress endpoint.
|
|
- DingTalk Stream text ingress (official SDK) wired into `cmd/dobotai`.
|
|
|
|
## DingTalk channel (Stream, text only)
|
|
|
|
- Uses the official DingTalk Stream SDK (`dingtalk-stream-sdk-go`); no public webhook endpoint is exposed.
|
|
- Text messages only for now. Images, OpenAPI fallback, and card replies are not implemented yet.
|
|
- Group chats are handled only when the bot is @-mentioned; other group messages are ignored.
|
|
- Sessions: direct chats use one long-lived session per user; group chats share one session per group (default `shared` policy).
|
|
- Replies are sent via the callback's `sessionWebhook`, which is fail-closed: only `https` URLs on `*.dingtalk.com` (port 443, no redirects) are accepted.
|
|
- Required env vars to enable (all three or none): `DINGTALK_CLIENT_ID`, `DINGTALK_CLIENT_SECRET`, `DOBOTAI_TENANT_KEY`. Partial configuration is a fatal startup error.
|
|
|
|
## WeKnora baseline
|
|
|
|
Target policy: latest stable official Release/Tag. The newest locally fetched stable tag is `v0.6.3`. Online GitHub verification is pending because DNS/proxy access was unavailable during initialization.
|
|
|
|
## Run
|
|
|
|
1. Create an independent PostgreSQL database named `dobotai`.
|
|
2. Apply `db/migrations/000001_core.up.sql` to that database only.
|
|
3. Copy `.env.example` to a local `.env` and supply secrets outside Git.
|
|
4. Export the variables and run:
|
|
|
|
```bash
|
|
go run ./cmd/dobotai
|
|
```
|
|
|
|
Health check:
|
|
|
|
```bash
|
|
curl http://127.0.0.1:8090/healthz
|
|
```
|
|
|
|
Internal QA request:
|
|
|
|
```bash
|
|
curl -X POST http://127.0.0.1:8090/v1/qa \
|
|
-H "Authorization: Bearer $DOBOTAI_INGRESS_TOKEN" \
|
|
-H 'Content-Type: application/json' \
|
|
-d '{
|
|
"tenant_key":"default",
|
|
"channel":"dingtalk",
|
|
"conversation_type":"direct",
|
|
"external_user_id":"user-1",
|
|
"external_message_id":"message-1",
|
|
"query":"hello"
|
|
}'
|
|
```
|
|
|
|
## Hard boundaries
|
|
|
|
- No WeKnora source modifications.
|
|
- No custom WeKnora tables or columns.
|
|
- No direct WeKnora database access.
|
|
- No private WeKnora package imports.
|
|
- All compatibility logic stays in `internal/weknora`.
|
|
- Business data stays in DobotAI PostgreSQL.
|
|
- Redis will be used only for queues, retries, idempotency leases, and temporary state.
|
|
|
|
See `docs/architecture.md` for ownership and migration decisions.
|