Skip to content

Commit 036c472

Browse files
authored
Update index.mdx
1 parent 3292889 commit 036c472

File tree

1 file changed

+36
-8
lines changed

1 file changed

+36
-8
lines changed

sources/platform/actors/index.mdx

Lines changed: 36 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -33,19 +33,47 @@ import CardGrid from "@site/src/components/CardGrid";
3333

3434
## What is an Actor?
3535

36-
Actors are serverless programs running in the cloud. They can perform anything from simple actions (such as filling out a web form or sending an email) to complex operations (such as crawling an entire website or removing duplicates from a large dataset). Actor runs can be as short or as long as necessary. They could last seconds, hours, or even infinitely.
37-
[Read whitepaper](https://whitepaper.actor/)
36+
> [Read Actor whitepaper](https://whitepaper.actor/)
3837
39-
> **To get better idea of what Apify Actors are, visit [Apify Store](https://apify.com/store), and try out some of them!**
40-
> ![Apify Store](./running/images/store-google-maps-scraper.png)
38+
Actors are serverless programs that run in the cloud.
39+
They can perform anything from simple actions such as
40+
filling out a web form or sending an email,
41+
to complex operations such as crawling an entire website,
42+
or removing duplicates from a large dataset.
43+
Actors can persist their state and be restarted, and thus they can
44+
run as short or as long as necessary, from seconds to hours, even infinitely.
45+
46+
Basically, Actors are programs packaged as Docker images,
47+
which accept a well-defined JSON input, perform
48+
an action, and optionally produce a well-defined JSON output.
49+
50+
## What is an Actor made of?
51+
52+
Actors have the following elements:
4153

42-
You can use Actors [manually in Apify Console](https://console.apify.com/actors), by using the [API](/api/v2) or [scheduler](../schedules.md). You can easily [integrate them with other apps](../integrations/index.mdx) and share your Actors with other Apify users via [Apify Store](https://apify.com/store) or [access rights](./collaboration/access-rights) system.
54+
- **Dockerfile** which specifies where the Actor's source code is,
55+
how to build it, and run it.
56+
- **Documentation** in a form of a README.md file.
57+
- **Input and output schemas** that describe what input the Actor requires,
58+
and what results it produces.
59+
- Access to an out-of-the-box **storage system** for Actor data, results, and files.
60+
- **Metadata** such as the Actor name, description, author, and version.
4361

44-
## Actors are containers
62+
The documentation and the input/output schemas make it possible for people to easily understand what the Actor does,
63+
enter the required inputs both in user interface or API,
64+
and integrate the results of the Actor into their other workflows.
65+
Actors can easily call and interact with each other, enabling the building of more complex
66+
systems on top of simple ones.
4567

46-
A single isolated Actor consists of source code and various settings. You can think of an Actor as a cloud app or service that runs on the Apify platform. The run of an Actor is not limited to the lifetime of a single HTTP transaction. It can run for as long as necessary, even forever.
68+
![Apify Actor diagram](./images/apify-actor-drawing.png)
69+
70+
## Running Actors
71+
72+
You can run Actors manually in [Apify Console](https://console.apify.com/actors), using the [API](/api), [CLI](/cli), or [scheduler](../schedules). You can easily [integrate Actors](../integrations/index.mdx) with other apps, [share](./collaboration/access-rights) them with other people, [publish](./publishing) them in [Apify Store](https://apify.com/store), and even [monetize](./publishing/monetize).
73+
74+
> **To get better idea of what Apify Actors are, visit [Apify Store](https://apify.com/store), and try out some of them!**
75+
> ![Apify Store](./running/images/store-google-maps-scraper.png)
4776
48-
Basically, Actors are programs packaged as [Docker images](https://hub.docker.com/), which accept a well-defined JSON input, perform an action, and optionally produce an output.
4977

5078
## Public and private Actors
5179

0 commit comments

Comments
 (0)