# Inputs and Outputs for actions

GitHub Actions’da **kendi oluşturduğun bir aksiyonu** (yani “Custom Action”’ı) belirli bir **metadata** dosyasıyla tanımlarsın (genelde `action.yml` adında). Bu dosyada:

1. **inputs** (girdiler):
   * Action’ı kullanmak isteyen birisi, hangi parametreleri verebileceğini gösterir.
   * Bu girdiler, action çalışırken içindeki kod tarafından **kullanılır.**
2. **outputs** (çıktılar):
   * Action çalıştığında üretebileceği sonuçları tanımlar.
   * Başka step’ler veya job’lar, bu çıktıları “`steps.<action-id>.outputs.<output-name>`” şeklinde okuyarak **kullanabilir**.
3. **runs**:
   * Aksiyonunun hangi **teknoloji/tür** üzerine çalıştığını belirtir. Örneğin:
     * “`using: node20`” diyerek bunun bir **JavaScript action** olduğunu ve Node.js 20 ile çalıştığını söylersin,
     * “`using: docker`” diyerek Docker container tabanlı bir action kullandığını belirtirsin,
     * “`using: composite`” diyerek YAML step’lerden oluşan bir “composite action” olduğunu söylersin.

Kısacası, **“inputs ve outputs”** action’ın parametrelerini ve üreteceği verileri tanımlarken, **“runs”** ise action’ın hangi ortamda veya hangi giriş noktasıyla (ör. `main.js`) çalıştığını belirler.

#### Kısaca Örnek Action Dosyası (action.yml)

```yaml
name: "Draw Octocats"

description: "Draws a certain number of Octocats with specified eye color"

inputs:
  num-octocats:
    description: "Number of Octocats"
    required: false
    default: "1"
  octocat-eye-color:
    description: "Eye color of the Octocats"
    required: true

outputs:
  sum:
    description: "The sum of the inputs"

runs:
  using: "node20"
  main: "main.js"
```

* Burada tanımlanan **`inputs`** ve **`outputs`** action’ı kullanan workflow’larda parametre geçebilmeni, sonuç döndürebilmeni sağlar.
* “`runs`” kısmı action’ın türünü (JavaScript) ve giriş noktasını (`main.js`) belirtiyor.

***

### Sonuç

1. **Inputs**: Action’ın **neyi beklediğini** (kullanıcıdan girdi parametreleri)
2. **Outputs**: Action’ın **ne sonuç üretebileceğini**
3. **runs**: Action’ın hangi ortamda / hangi dosyayla çalıştığını tanımlarsın.

Böylece GitHub Actions’da **kendi custom action**’larını oluştururken, parametre alma ve geri sonuç döndürmeyi ayarlayarak **esnek** ve **yeniden kullanılabilir** bir aksiyon elde edersin.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://note.onurbolatoglu.com/github-actions/inputs-and-outputs-for-actions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.