Ihr erster agentischer Workflow

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

In diesem Artikel

Hinweis

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.

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.

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:

    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:

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:

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 .
  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:

    gh aw compile

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

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

    gh aw run daily-repo-status

Nächste Schritte