agents.json: eine Open-Source-Spezifikation für Intelligenzen zur Interaktion mit APIs über natürliche Sprache

🚀 Einladung zum Erleben: Chinas erste KI-IDE Intelligente Programmiersoftware Trae Chinesische Version downloadDer DeepSeek-R1 und Doubao-pro sind unbegrenzt verfügbar!

Allgemeine Einführung

agents.json ist eine Open-Source-Spezifikation, die vom Wildcard AI-Team auf der Grundlage des OpenAPI-Standards entwickelt wurde und Intelligenzen eine effiziente Kommunikation mit APIs über natürliche Sprache ermöglichen soll. Sie definiert den Interaktionsvertrag zwischen Intelligenzen und APIs durch strukturierte JSON-Dateien, optimiert die Endpunktsuche und Parametergenerierung und löst das Problem der chaotischen Reihenfolge und geringen Genauigkeit, wenn Intelligenzen APIs aufrufen. Das Projekt ist in der Version 0.1.0 auf GitHub (https://github.com/wild-card-ai/agents-json) unter der Apache 2.0-Lizenz gehostet, und die Beteiligung der Gemeinschaft wird gefördert. Mit dem Wildcard Bridge Python-Paket können Entwickler agents.json-Dateien laden, parsen und ausführen, um mehrstufige API-Aufrufe zu automatisieren.

Agents.json ist eine quelloffene JSON-Spezifikation, die den Vertrag für die Interaktion zwischen API und KI-Intelligenz formell beschreibt und auf dem OpenAPI-Standard aufbaut.

agents.json: eine Open-Source-Spezifikation für Intelligenzen zur Interaktion mit APIs über natürliche Sprache-1

Funktionsliste

Natürliche Sprache gesteuerte API-AufrufeIntelligentsia löst API-Operationen in Alltagssprache aus.
Erweiterungen auf der Grundlage von OpenAPINeue Interaktionsregeln für OpenAPI zur Optimierung der Nutzung von Intelligenzen.
Aufgabenabläufe und VerknüpfungenDefinition von mehrstufigen Aufgabenflüssen (Flows) und Aktionsverknüpfungen (Links), um die Anrufreihenfolge zu gewährleisten.
zustandsloses DesignClient-Management-Status zur Unterstützung bestehender Infrastrukturen.
SDK-UnterstützungWildcard Bridge lädt und führt Spezifikationsdateien aus, um die Entwicklung zu vereinfachen.

Hilfe verwenden

Zugang und Vorbereitung

agents.json ist eine Spezifikationsdatei, die in Verbindung mit dem SDK verwendet oder manuell geschrieben werden sollte. So funktioniert sie:

1. die Datei agents.json abrufen

offizielles Beispiel::
Holen Sie sich das Quick Start Notebook von Wildcard AI, z.B.:
- Erneut senden:resend.ipynb
- Gestreift:einzeln.ipynb
- Google Sheets, etc:mehrfach-dynamisch.ipynb

Individuelles Schreiben::
Stiftung Vollständiges Schemadie die Datei erstellt. Zum Beispiel:

{
"apiVersion": "0.1.0",
"baseUrl": "https://api.example.com",
"chains": {
"get_data": {
"description": "Abrufen bestimmter Daten",
"agent_instructions": "Daten auf der Grundlage von Benutzereingaben extrahieren",
"steps": [{ "endpoint": "/data", "method": "GET"}]
}
}
}

Es wird empfohlen, die /.well-known/agents.json Wege, die von der Intelligenz leicht entdeckt werden können.

2. die Installation der Wildcard-Brücke

AnfragePython 3.10+.

umziehen::

Befehl ausführen:
```
pip install wildcard-bridge
```

Validierung:

python -c "import wildcard_bridge; print(wildcard_bridge.__version__)"

3. die Konfigurationsumgebung

Unterstützung bei der ZertifizierungBasic, ApiKey und Bearer-Authentifizierung werden unterstützt. Beispiel:
```
from wildcard_bridge import Bridge
bridge = Bridge(auth={"type": "ApiKey", "key": "your-api-key"})
```
Vernetzte IntelligenzZugriff auf unterstützte LLMs (z. B. OpenAI) und Vorbereitung von Basis-Prompts.

Bedienung der Hauptfunktionen

Funktion 1: Laden und Parsen der Spezifikationsdatei

umziehen::

Datei laden:

bridge.load_agents_json("pfad/zu/agents.json")

Betrachten Sie die Aufgabenkette:

chains = bridge.get_available_chains()
print(chains) # Verfügbare Aufgaben ausgeben, z.B. ["get_data"]

verwenden.Verständnis der unterstützten Operationen, bereit zur Ausführung.

Funktion 2: Ausführung von Aufgabenabläufen

umziehen::

Führen Sie die Aufgabe aus:

result = bridge.run_chain("get_data", {"query": "sales report"})
print(result) # Output API Return Results

Überprüfen Sie die Rücksendedaten.

Nehmen SieDer Benutzer sagt: "Gib mir den Verkaufsbericht", und der Smart Body ruft automatisch die API auf.

Funktion 3: Fehlersuche und Optimierung

Komponenten während der Prüfung anpassen::
```
bridge.enable_debug()
Ergebnis = bridge.run_chain("get_data", {"query": "test"})
```
Überprüfen Sie die Protokolle, um sicherzustellen, dass jeder Schritt korrekt ist.
OptimierungAnpassungen agent_instructions oder Beispiele, um die Genauigkeit der Intelligenz zu verbessern.

Featured Function Bedienung

Aufgabenablauf und Verknüpfungsdesign

Arbeitsablauf::

Definieren Sie mehrstufige Aufgabenabläufe, wie z. B. Google Mail-Antworten:

{
"Ketten": {
"reply_email": {
"description": "Antworten auf E-Mails",
"agent_instructions": "Antwortet auf E-Mails basierend auf Benutzereingaben",
"steps": [
{ "endpoint": "/threads/{threadId}", "method": "GET"}, { "endpoint": "/threads/{threadId}", "method": "GET"}, }
{"endpoint": "/messages/send", "method": "POST"}
]
}
}
}

Laufen:

bridge.run_chain("reply_email", {"threadId": "123", "reply": "received"})

LichtblickDie Abläufe und Verknüpfungen stellen sicher, dass die Anrufe in der richtigen Reihenfolge erfolgen und die Intelligenz nicht über sie nachdenken muss.

Zustandslose Kompatibilität mit bestehenden Systemen

realisieren::
Das SDK läuft auf der Client-Seite und ist für serverlose Umgebungen angepasst:

def lambda_handler(event, context).
bridge = Bridge(auth={"type": "Bearer", "Token": event["token"]})
bridge.load_agents_json("s3://bucket/agents.json")
return bridge.run_chain("task", event["args"])

SchneidkanteEs ist nicht erforderlich, den API-Server zu ändern, sondern ihn einfach zu verwenden.

Beispiel: Stripe-Zahlungsanfrage

agents.json::

{
"baseUrl": "https://api.stripe.com/v1",
"chains": {
"check_payment": {
"description": "Zahlungsstatus prüfen",
"agent_instructions": "Gibt den Status basierend auf der Zahlungs-ID zurück",
"steps": [{ "endpoint": "/charges/{chargeId}", "method": "GET"}]
}
}
}

in Bewegung sein::

result = bridge.run_chain("check_payment", {"chargeId": "ch_123"})
print(ergebnis)

WirkungDer intelligente Körper gibt den Zahlungsstatus direkt zurück, was einfach und effizient ist.

caveat

BürgschaftSchlüssel werden in Umgebungsvariablen gespeichert, um ein Auslaufen zu verhindern.
kommunal: Beitreten Diskord Holen Sie sich Unterstützung.
(Computer-)Datei: Referenz offizielles Dokument.