5 AI Weekly Report Summary

5 AI Weekly Report Summary

5.1 AI Weekly Report Summary Overview

The plugin can automatically analyze your work data and generate professional weekly summaries. The main AI features include:

  • Intelligent Content Summarization: Automatically extracts key information and generates concise and clear work summaries.

  • Multilingual Support: Supports content analysis in multiple languages such as Chinese and English.

  • Long Text Processing: Intelligently chunks long content to ensure completeness and accuracy of summaries.

  • Personalized Customization: Supports custom prompts to meet the reporting style needs of different teams.

5.2 Supported AI Providers

Supports multiple mainstream AI service providers, allowing you to choose the appropriate service as needed:

5.2.1 OpenAI and Compatible APIs

  • Applicable Scenarios: General usage, good support for both Chinese and English.

  • Official Model Recommendations: gpt-3.5-turbo (economical), gpt-4 (high quality).

  • Compatible Providers:

    • DeepSeek: Models such as deepseek-chat, deepseek-coder.

    • Qwen: Models such as qwen-turbo, qwen-plus.

    • GLM (Zhipu AI): Models such as glm-4, glm-3-turbo.

    • Moonshot (Kimi): Models such as moonshot-v1-8k, moonshot-v1-32k.

    • Baichuan Intelligence: Model such as baichuan2-turbo.

    • Other OpenAI-compatible service providers.

  • Configuration Requirements:

    • For OpenAI: Requires OpenAI API Key.

    • For compatible providers: Requires corresponding API Key and endpoint URL.

Configuration Example:

  • OpenAI:

    • API Endpoint: https://api.openai.com/v1

    • Model: gpt-3.5-turbo

  • DeepSeek:

    • API Endpoint: https://api.deepseek.com/v1

    • Model: deepseek-chat

  • Qwen:

    • API Endpoint: https://dashscope.aliyuncs.com/compatible-mode/v1

    • Model: qwen-turbo

5.2.2 Local Deployment (Ollama)

  • Applicable Scenarios: Environments with strict data privacy requirements.

  • Recommended Models: Open-source models like llama2, mistral, qwen.

  • Configuration Requirements: Requires local Ollama service address.

Important Note
Most AI service providers offer OpenAI-compatible API interfaces. This means you can use various compatible AI services under the "OpenAI" configuration option, just by:

  1. Replacing the API endpoint with the service provider's address.

  2. Using the provider’s API Key.

  3. Selecting a model supported by the provider.

This design greatly expands your choices for AI services, allowing you to select the most suitable one based on cost, performance, data security, etc.

image-20250804-092102.png

 

5.3 AI Configuration Steps

5.3.1 Access the AI Configuration Page

  1. Log in to Confluence as an administrator.

  2. Navigate to “Administration” → “Manage Apps”.

  3. In the left-side menu, find “ReportWise for Confluence”.

  4. Click the “AI config information” option.

image-20250804-092507.png

5.3.2 Enable AI Features

  1. At the top of the AI configuration page, locate the “Enable AI” toggle switch.

  2. Turn the switch to the “On” position.

  3. The system will then display the AI configuration options.

image-20250804-092706.png

5.3.3 Configure AI Providers

Basic Configuration Parameters:

  • Provider Type: Select the AI provider you want to use.

  • API Endpoint: Enter the corresponding API URL.

  • API Key: Input your API key.

  • Model Name: Specify the exact model you want to use.

Advanced Configuration Parameters:

  • Connection Timeout: Timeout duration for API requests (default: 30 seconds).

  • Retry Attempts: Number of retries on connection failure (default: 3).

  • Max Response Tokens: Limit the maximum length of AI responses (default: 2000).

  • Temperature: Controls the creativity of AI responses (range 0–1, default: 0.7).

image-20250804-093002.png
image-20250804-093042.png

5.3.4 Connection Test

After completing the configuration, click the “Test Connection” button to verify it:

  • Success: A green prompt appears — “Connection successful”.

  • Failure: Specific error messages will be shown, such as “Invalid API key” or “Network timeout”.

image-20250804-093206.png
image-20250804-093135.png

5.4 AI Feature Use Cases

5.4.1 Personal Weekly Report Summary

When you create a personal weekly report, AI will automatically analyze the work content you entered and generate a structured summary:

  • Highlight Extraction: Identifies key achievements and important progress.

  • Problem Summary: Organizes difficulties and challenges encountered.

  • Next Week Suggestions: Provides reasonable plans based on current progress.

5.4.2 Project Weekly Report Summary

The AI summary feature for project reports focuses more on team collaboration and project progress:

  • Project Progress Analysis: Evaluates completion status and milestone achievement.

  • Team Contribution Summary: Summarizes the key contributions of team members.

  • Risk Identification: Identifies potential project risks and obstacles.

  • Resource Demand Analysis: Analyzes resource allocation and changes in project needs.

How to Use:
Add the variable $aiSummary in personal or project report blueprints.

5.5 Troubleshooting

5.5.1 Common Configuration Issues

Issue: Unable to Enable AI Features

  • Check whether you have administrator permissions.

  • Confirm that the plugin version supports AI features.

  • Check system logs for detailed error messages.

Issue: API Connection Failed

  • Verify if the API key is correct.

  • Check network connectivity and firewall settings.

  • Ensure the API endpoint format is correct.

Issue: Poor AI Summary Quality

  • Improve the detail level of input prompts.

  • Adjust the temperature parameter (lower it to reduce randomness).

  • Try different AI models.