docs: add Upsonic integration documentation by IremOztimur · Pull Request #2350 · apify/apify-docs

IremOztimur · 2026-03-23T08:13:20Z

Summary

Adds integration guide for Upsonic, an open-source Python framework for building AI agents
Covers basic setup with ApifyTools and an advanced restaurant discovery agent example using Google Places Crawler
Documents all ApifyTools configuration options with types and defaults

marcel-rbro · 2026-03-23T17:53:10Z

sources/platform/integrations/ai/upsonic.md

+
+## What is Upsonic?
+
+[Upsonic](https://upsonic.ai) is an open-source Python framework for building AI agents. Supporting any LLM (e.g. OpenAI, Anthropic, Azure, Bedrock), it provides an `AutonomousAgent` class, an OpenClaw-like autonomous agent with built-in shell and filesystem access, a safety engine for policy-based content filtering, built-in OCR and document processing, session and long-term memory, multi-agent coordination, MCP server support, and [Universal Commerce Protocol (UCP)](https://github.com/Upsonic/awesome-ucp) tools for AI-driven commerce workflows.


This sentence is ~55 words — well over the 30-word limit. Also missing an Oxford comma and "and" before "Bedrock".

Consider converting the feature list to bullet points:

Suggested change

[Upsonic](https://upsonic.ai) is an open-source Python framework for building AI agents. Supporting any LLM (e.g. OpenAI, Anthropic, Azure, Bedrock), it provides an `AutonomousAgent` class, an OpenClaw-like autonomous agent with built-in shell and filesystem access, a safety engine for policy-based content filtering, built-in OCR and document processing, session and long-term memory, multi-agent coordination, MCP server support, and [Universal Commerce Protocol (UCP)](https://github.com/Upsonic/awesome-ucp) tools for AI-driven commerce workflows.

[Upsonic](https://upsonic.ai) is an open-source Python framework for building AI agents. It supports any LLM (e.g., OpenAI, Anthropic, Azure, and Bedrock) and provides:

- An `AutonomousAgent` class with built-in shell and filesystem access

- A safety engine for policy-based content filtering

- Built-in OCR and document processing

- Session and long-term memory

- Multi-agent coordination and MCP server support

- [Universal Commerce Protocol (UCP)](https://github.com/Upsonic/awesome-ucp) tools for AI-driven commerce workflows

marcel-rbro · 2026-03-23T17:53:14Z

sources/platform/integrations/ai/upsonic.md

+
+## How to use Apify with Upsonic
+
+This guide shows how to integrate Apify Actors with Upsonic using the built-in `ApifyTools` class. The example builds a restaurant discovery agent that uses the [Google Places Crawler](https://apify.com/compass/crawler-google-places) Actor to search Google Maps with a natural language query and save the results to a Markdown file.


This sentence is 44 words (limit: 30). Split into two:

Suggested change

This guide shows how to integrate Apify Actors with Upsonic using the built-in `ApifyTools` class. The example builds a restaurant discovery agent that uses the [Google Places Crawler](https://apify.com/compass/crawler-google-places) Actor to search Google Maps with a natural language query and save the results to a Markdown file.

This guide shows how to integrate Apify Actors with Upsonic using the built-in `ApifyTools` class. The example builds a restaurant discovery agent that uses the [Google Places Crawler](https://apify.com/compass/crawler-google-places) Actor to search Google Maps with a natural language query. It saves the results to a Markdown file.

marcel-rbro · 2026-03-23T17:53:17Z

sources/platform/integrations/ai/upsonic.md

+
+## Basic integration example
+
+Set up a Upsonic agent with Apify tools. This example uses the [RAG Web Browser](https://apify.com/apify/rag-web-browser) Actor to extract content from a URL.


"Upsonic" starts with a vowel sound (/ʌp/), so it takes "an":

Suggested change

Set up a Upsonic agent with Apify tools. This example uses the [RAG Web Browser](https://apify.com/apify/rag-web-browser) Actor to extract content from a URL.

Set up an Upsonic agent with Apify tools. This example uses the [RAG Web Browser](https://apify.com/apify/rag-web-browser) Actor to extract content from a URL.

sources/platform/integrations/ai/upsonic.md

IremOztimur · 2026-03-27T13:58:53Z

@marcel-rbro hey, is everything resolved? let me know if any changes are needed.

marcel-rbro · 2026-04-02T10:58:04Z

@IremOztimur some of the comments are not applied though. For example:

I added suggestions, this is one-shottable with an AI.

- Break long feature list into bullet points for readability - Split 44-word sentence into two shorter sentences - Fix grammar: "a Upsonic" → "an Upsonic" - Remove italics from prerequisite labels - Lowercase "Restaurant" in heading after colon - Use imperative tone in LLM providers tip - Replace "Check out" with "See" - Use action-oriented link text for Apify Store resource

IremOztimur · 2026-04-02T19:20:43Z

hi @marcel-rbro , now I have applied all your review suggestions. Thanks for your review.

Add missing article "the" before Apify Store and Apify Console per terminology standards. Change sample output code fence from text to markdown for proper syntax highlighting. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

All other AI integration pages include this standard disclaimer. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

marcel-rbro

We've added a 3rd party integration note to all integration pages in the meantime. I've added that to this PR. Looks good now, thanks 👍

Capitalize after colon in heading to pass Vale check. Remove question mark from heading. Unwrap Upsonic docs link from admonition. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

IremOztimur requested a review from TC-MO as a code owner March 23, 2026 08:13

TC-MO requested review from marcel-rbro and removed request for TC-MO March 23, 2026 08:38

marcel-rbro requested review from TC-MO and removed request for TC-MO March 23, 2026 09:04

IremOztimur force-pushed the feat/upsonic-integration branch from 0380fb4 to 3341ed4 Compare March 23, 2026 13:42