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:

go run ./cmd/dobotai

Health check:

curl http://127.0.0.1:8090/healthz

Internal QA request:

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.