图表可视化
visualization-reporting
Transforms raw metrics and analysis into visual charts and published, shareable HTML reports using Google Cloud Storage.
文件预览
1 个文件
SKILL.md
1.7 KB · 可预览
---
name: visualization-reporting
description: Transforms raw metrics and analysis into visual charts and published, shareable HTML reports using Google Cloud Storage.
---
### Skill: Visualization & Reporting Workflow
**Objective**: Transform raw numerical data and insights into beautiful, shareable assets. You must distinguish between saving an internal Artifact and Publishing an external file.
**Execution Steps**:
1. **Confirm Data**: Ensure you have gathered the necessary metrics (e.g., a dictionary of channels and their engagement rates) or the final synthesized text.
2. **Visualize**: Delegate to the `visualization_agent` to create static charts. Pass the raw data to it. The sub-agent will save the chart as an internal Artifact and return its name.
3. **Retrieve Artifact**: Use the `load_artifacts` tool to load the raw bytes of the image artifact from the session memory.
4. **Publish Dependencies to GCS**: If your final HTML report will display the image, you MUST publish the image bytes FIRST using `publish_file(content, filename, "image/png")`. This returns a public `https://storage.googleapis.com/...` URL.
5. **Construct HTML**: Create a clean, well-formatted HTML string containing your analysis. Embed the charts using the *public URLs* obtained in step 4 (e.g., `<img src="https://storage.../chart.png" />`). Do NOT use local paths.
6. **Final Delivery Options**:
- **If the user just wants the report saved**: Call `render_html(html_content, "report.html")` to save it as an internal artifact they can download later.
- **If the user wants a shareable link**: Call `publish_file(html_content, "report.html", "text/html")` to upload the final HTML string to GCS and return the public URL directly to the user.
SKILL.md
元数据
| name | visualization-reporting |
|---|---|
| description | Transforms raw metrics and analysis into visual charts and published, shareable HTML reports using Google Cloud Storage. |
Skill: Visualization & Reporting Workflow
Objective: Transform raw numerical data and insights into beautiful, shareable assets. You must distinguish between saving an internal Artifact and Publishing an external file.
Execution Steps:
- Confirm Data: Ensure you have gathered the necessary metrics (e.g., a dictionary of channels and their engagement rates) or the final synthesized text.
- Visualize: Delegate to the
visualization_agentto create static charts. Pass the raw data to it. The sub-agent will save the chart as an internal Artifact and return its name. - Retrieve Artifact: Use the
load_artifactstool to load the raw bytes of the image artifact from the session memory. - Publish Dependencies to GCS: If your final HTML report will display the image, you MUST publish the image bytes FIRST using
publish_file(content, filename, "image/png"). This returns a publichttps://storage.googleapis.com/...URL. - Construct HTML: Create a clean, well-formatted HTML string containing your analysis. Embed the charts using the public URLs obtained in step 4 (e.g.,
<img src="https://storage.../chart.png" />). Do NOT use local paths. - Final Delivery Options:
- If the user just wants the report saved: Call
render_html(html_content, "report.html")to save it as an internal artifact they can download later. - If the user wants a shareable link: Call
publish_file(html_content, "report.html", "text/html")to upload the final HTML string to GCS and return the public URL directly to the user.
- If the user just wants the report saved: Call