---
canonical: "https://agi-labo.com/tools/wings/docs/first-handler"
title: "最初の Handler"
description: "小さな関数を実行し、保存して、結果を確認します。"
section: "はじめに"
order: 3
pageType: "tutorial"
lastVerifiedVersion: "1.4.16"
lastVerifiedAt: "2026-10-15"
draft: false
surfaces: ["cli", "console"]
plans: ["free", "member"]
---

[ログイン](/tools/wings/docs/getting-started)を済ませ、次を `handler.js` として保存します。

```js
export default async function (event) {
  return { message: `Hello, ${event.name ?? 'Wings'}` }
}
```

## 登録する前に実行する

```sh
wings run --file handler.js --event '{"name":"Wings"}'
```

結果の `message` が `Hello, Wings` なら成功です。
この操作でも、コードはクラウドで動きます。

## Handler として登録する

```sh
wings handler deploy --name hello --file handler.js
wings handler list
```

一覧に表示された ID を、次の `<handler-id>` に置き換えます。

```sh
wings run <handler-id> --event '{"name":"Wings"}'
wings handler logs <handler-id>
```

同じ `Hello, Wings` が返り、Run が成功になれば確認完了です。
[Console](https://console.wings.agi-labo.com/)でも Handler と Run を確認できます。

外部 API を使う場合は、[Connection](/tools/wings/docs/connections)を設定します。
定期的に動かす場合は、[Schedule](/tools/wings/docs/schedules)を追加してください。