# Ihr erster agentischer Workflow

Bringen Sie Ihre erste KI-gestützte Automatisierung mit einem vorgefertigten Workflow und der GitHub CLI zum Laufen.

> \[!NOTE]
> GitHub agentenbasierte Workflows are in Öffentliche Vorschau and subject to change.

## Einführung

GitHub agentenbasierte Workflows Ermöglichen Sie es Ihnen, Repositoryaufgaben mithilfe von KI-basierten Workflows zu automatisieren. Eine Übersicht über GitHub agentenbasierte Workflows finden Sie unter [Informationen zu GitHub-Agenten-Workflows](/de/enterprise-cloud@latest/copilot/concepts/agents/about-github-agentic-workflows).

In diesem Leitfaden fügen Sie einem vorhandenen Repository einen vordefinierten agentischen Workflow – einen täglichen Repositorystatusbericht – hinzu. Dies dauert etwa 10 Minuten und liefert Ihnen ein funktionierendes Beispiel für automatisierte Agenten, die in GitHub Actions ausgeführt werden.

Diese Schnellstartanleitung konzentriert sich auf die Ausführung Ihres ersten Workflows. Ausführlichere Anleitungen zur Einrichtung und Problembehandlung finden Sie auf der [DokumentationswebsiteGitHub agentenbasierte Workflows](https://github.github.com/gh-aw/).

## Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie folgendes haben:

* Ein KI-Konto: GitHub Copilot, , Anthropic Claude, OpenAI Codexoder Google Gemini
* Ein GitHub Repository, in dem Sie Schreibzugriff haben
* GitHub Actions für das Repository aktiviert
* GitHub CLI (`gh`) v2.0.0 oder höher installiert und authentifiziert

  Führen Sie zum Überprüfen der Version `gh --version` aus. Führen Sie zum Authentifizieren Folgendes aus:

  ```shell
  gh auth login --scopes repo,workflow
  ```

Sie können diesen Schnellstart mit jeder unterstützten Engine durchführen.
GitHub Copilot ist die Standard-Engine, und ein GitHub Copilot-Tarif ist nur erforderlich, wenn Sie diesen wählen.

Unterstützte Betriebssysteme sind Linux, macOS und Windows mit WSL.

## Schritt 1: Installieren der `gh aw` Erweiterung

Installieren Sie die GitHub agentenbasierte Workflows-Erweiterung für das GitHub CLI:

```shell
gh extension install github/gh-aw
```

## Schritt 2: Hinzufügen eines Workflows und Auslösen einer Ausführung

Führen Sie im Stammverzeichnis des Repositorys Folgendes aus:

```shell
gh aw add-wizard githubnext/agentics/daily-repo-status
```

Der `add-wizard` Befehl akzeptiert Workflowverweise im `OWNER/REPO/WORKFLOW-NAME` Format. Dieser interaktive Prozess umfasst:

1. Überprüfen Sie die Voraussetzungen des Repositorys.
2. Aufforderung zur Auswahl einer KI-Engine (Copilot ist standardmäßig ausgewählt, oder wählen Sie eine andere Engine aus).
3. Leitet Sie durch die Einrichtung von Secret und Authentifizierung für die von Ihnen gewählte Engine. Je nach der ausgewählten Engine fordert Sie der Assistent möglicherweise auf, `COPILOT_GITHUB_TOKEN`, `ANTHROPIC_API_KEY`, `OPENAI_API_KEY` oder `GEMINI_API_KEY` zu konfigurieren. Anweisungen zum Einrichten finden Sie im [Authentifizierungsreferenzartikel](https://github.github.com/gh-aw/reference/auth/) .
4. Generieren Sie die Workflowmarkdowndatei, und kompilieren Sie die entsprechende `.lock.yml` Datei.
5. Öffnen Sie einen Pull Request, der beide generierten Dateien in `.github/workflows/` hinzufügt.
6. Lassen Sie die Pullanforderung selbst überprüfen und zusammenführen, oder wählen Sie einen Fluss aus, der sie für Sie zusammenführt.

Nachdem der Workflow erstellt wurde, werden Sie gefragt, ob Sie ihn sofort ausführen möchten. Wählen Sie **"Ja** " aus, um den Workflow auszulösen.

## Schritt 3: Warten, bis der Workflow abgeschlossen ist

Eine automatisierte Workflowausführung dauert in der Regel 2 bis 3 Minuten. Sobald der Vorgang abgeschlossen ist, erscheint in Ihrem Repository ein neues Issue mit einem täglichen Statusbericht, der Folgendes analysiert:

* Letzte Repositoryaktivität (Probleme, Pullanforderungen, Diskussionen, Versionen)
* Fortschrittsverfolgung und Hervorhebungen
* Konkrete nächste Schritte für Maintainer

## Schritt 4: Anpassen des Workflows (optional)

Sie können den Workflow so bearbeiten, dass er Ihren Prioritäten entspricht:

1. Öffnen Sie `.github/workflows/daily-repo-status.md` in Ihrem Repository.

2. Bearbeiten Sie den Markdown-Text, um zu beschreiben, was der Bericht abdecken soll – z. B. Ihr Issue-Backlog, Ihr CI-Setup, Tests, Performance oder die Roadmap.

3. Wenn Sie die Frontmatterkonfiguration geändert haben, kompilieren Sie den Workflow neu:

   ```shell
   gh aw compile
   ```

4. Übernehmen Sie den Commit, und übertragen Sie Ihre Änderungen.

5. Sie können optional eine andere Ausführung auslösen:

   ```shell
   gh aw run daily-repo-status
   ```

## Nächste Schritte

* Zum Erstellen Ihres eigenen benutzerdefinierten agentische Workflows siehe [Erstellen von agentenbasierten GitHub-Workflows](/de/enterprise-cloud@latest/copilot/how-tos/github-agentic-workflows/creating-github-agentic-workflows).
* Erweiterte Muster und vollständige Referenz finden Sie auf der [GitHub agentenbasierte Workflows Dokumentationswebsite](https://github.github.com/gh-aw/).