mirror of https://github.com/Significant-Gravitas/AutoGPT.git synced 2026-04-08 03:00:28 -04:00

Files

Nicholas Tindle c1a1767034 feat(docs): Add block documentation auto-generation system (#11707 )

- Add generate_block_docs.py script that introspects block code to
generate markdown
- Support manual content preservation via <!-- MANUAL: --> markers
- Add migrate_block_docs.py to preserve existing manual content from git
HEAD
- Add CI workflow (docs-block-sync.yml) to fail if docs drift from code
- Add Claude PR review workflow (docs-claude-review.yml) for doc changes
- Add manual LLM enhancement workflow (docs-enhance.yml)
- Add GitBook configuration (.gitbook.yaml, SUMMARY.md)
- Fix non-deterministic category ordering (categories is a set)
- Add comprehensive test suite (32 tests)
- Generate docs for 444 blocks with 66 preserved manual sections

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

<!-- Clearly explain the need for these changes: -->

### Changes 🏗️

<!-- Concisely describe all of the changes made in this pull request:
-->

### Checklist 📋

#### For code changes:
- [x] I have clearly listed my changes in the PR description
- [x] I have made a test plan
- [x] I have tested my changes according to the test plan:
  <!-- Put your test plan here: -->
  - [x] Extensively test code generation for the docs pages



<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Introduces an automated documentation pipeline for blocks and
integrates it into CI.
> 
> - Adds `scripts/generate_block_docs.py` (+ tests) to introspect blocks
and generate `docs/integrations/**`, preserving `<!-- MANUAL: -->`
sections
> - New CI workflows: **docs-block-sync** (fails if docs drift),
**docs-claude-review** (AI review for block/docs PRs), and
**docs-enhance** (optional LLM improvements)
> - Updates existing Claude workflows to use `CLAUDE_CODE_OAUTH_TOKEN`
instead of `ANTHROPIC_API_KEY`
> - Improves numerous block descriptions/typos and links across backend
blocks to standardize docs output
> - Commits initial generated docs including
`docs/integrations/README.md` and many provider/category pages
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
631e53e0f6. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

2026-01-19 07:03:19 +00:00

3.6 KiB

Raw Blame History

Ayrshare Post To LinkedIn

Blocks for posting content to LinkedIn using the Ayrshare social media management API.

Post To Linked In

What it is

Post to LinkedIn using Ayrshare

How it works

This block uses Ayrshare's social media API to post content to LinkedIn. It handles text posts, images, videos, and documents, with support for scheduling and audience targeting. The block authenticates through Ayrshare's API.

LinkedIn-specific features include visibility controls, comment management, and targeting by country, seniority, industry, and other demographics (requires 300+ followers in target audience).

Inputs

Input	Description	Type	Required
post	The post text (max 3,000 chars, hashtags supported with #)	str	No
media_urls	Optional list of media URLs. LinkedIn supports up to 9 images, videos, or documents (PPT, PPTX, DOC, DOCX, PDF <100MB, <300 pages).	List[str]	No
is_video	Whether the media is a video	bool	No
schedule_date	UTC datetime for scheduling (YYYY-MM-DDThh:mm:ssZ)	str (date-time)	No
disable_comments	Whether to disable comments	bool	No
shorten_links	Whether to shorten links	bool	No
unsplash	Unsplash image configuration	str	No
requires_approval	Whether to enable approval workflow	bool	No
random_post	Whether to generate random post text	bool	No
random_media_url	Whether to generate random media	bool	No
notes	Additional notes for the post	str	No
visibility	Post visibility: 'public' (default), 'connections' (personal only), 'loggedin'	str	No
alt_text	Alt text for each image (accessibility feature, not supported for videos/documents)	List[str]	No
titles	Title/caption for each image or video	List[str]	No
document_title	Title for document posts (max 400 chars, uses filename if not specified)	str	No
thumbnail	Thumbnail URL for video (PNG/JPG, same dimensions as video, <10MB)	str	No
targeting_countries	Country codes for targeting (e.g., ['US', 'IN', 'DE', 'GB']). Requires 300+ followers in target audience.	List[str]	No
targeting_seniorities	Seniority levels for targeting (e.g., ['Senior', 'VP']). Requires 300+ followers in target audience.	List[str]	No
targeting_degrees	Education degrees for targeting. Requires 300+ followers in target audience.	List[str]	No
targeting_fields_of_study	Fields of study for targeting. Requires 300+ followers in target audience.	List[str]	No
targeting_industries	Industry categories for targeting. Requires 300+ followers in target audience.	List[str]	No
targeting_job_functions	Job function categories for targeting. Requires 300+ followers in target audience.	List[str]	No
targeting_staff_count_ranges	Company size ranges for targeting. Requires 300+ followers in target audience.	List[str]	No

Outputs

Output	Description	Type
error	Error message if the operation failed	str
post_result	The result of the post	PostResponse
post	The result of the post	PostIds

Possible use case

Thought Leadership: Automatically share blog posts or industry insights with professional network.

Scheduled Content: Queue up a week's worth of LinkedIn posts with scheduled publishing times.

Targeted Announcements: Share company updates targeted to specific industries or seniority levels.

3.6 KiB Raw Blame History