{"meta":{"title":"Clientinformationen","intro":"Clientinformationen identifizieren die Anwendung, die das Copilot SDK verwendet, und, falls zutreffend, eine bestimmte Integration innerhalb dieser Anwendung. Eine Integration ist ein identifizierbarer Teil der Anwendung, über die das SDK verwendet wird, z. B. eine Erweiterung oder ein Plug-In. Legen Sie die optionale clientInfo-Clientoption fest, um die Laufzeittelemetrie für diese Verbindung Ihrer Anwendung statt dem Build der Laufzeit selbst zuzuordnen.","product":"GitHub Copilot","breadcrumbs":[{"href":"/de/copilot","title":"GitHub Copilot"},{"href":"/de/copilot/how-tos","title":"Vorgehensweisen"},{"href":"/de/copilot/how-tos/copilot-sdk","title":"Copilot SDK"},{"href":"/de/copilot/how-tos/copilot-sdk/features","title":"Funktionen"},{"href":"/de/copilot/how-tos/copilot-sdk/features/client-info","title":"Client-Info"}],"documentType":"article"},"body":"# Clientinformationen\n\nClientinformationen identifizieren die Anwendung, die das Copilot SDK verwendet, und, falls zutreffend, eine bestimmte Integration innerhalb dieser Anwendung. Eine Integration ist ein identifizierbarer Teil der Anwendung, über die das SDK verwendet wird, z. B. eine Erweiterung oder ein Plug-In. Legen Sie die optionale clientInfo-Clientoption fest, um die Laufzeittelemetrie für diese Verbindung Ihrer Anwendung statt dem Build der Laufzeit selbst zuzuordnen.\n\n\n\n\n## Wann Clientinformationen festgelegt werden sollen\n\nLegen Sie Clientinformationen fest, wenn Ihre SDK-Anwendung ein anderes Produkt, einen dienst oder eine bestimmte Integration darstellt, deren Laufzeitaktivität konsistent zugeordnet werden soll.\n\nLassen Sie die Clientinformationen für Skripts, einmalige Tools und Aufträge, die keine eigenständige Anwendung darstellen, nicht festgelegt. Die Laufzeit behält dann die Standardzuordnung bei.\n\nClientinformationen enthalten vier optionale Zeichenfolgenfelder. Legen Sie die Felder fest, die Sie kennen, und lassen Sie den Rest aus. Das SDK enthält Clientinformationen nur dann im `server.connect` Handshake, wenn mindestens ein Feld einen nicht leeren Wert aufweist.\n\n| Feld | Example | Bedeutung |\n|---|---|---|\n| `applicationName` | `\"vscode\"` | Name der Anwendung mit dem SDK |\n| `applicationVersion` | `\"1.124.2\"` | Version der Anwendung mit dem SDK |\n| `integrationName` | `\"copilot-chat\"` | Name der Erweiterung, des Plug-Ins oder eines anderen Anwendungsunterteils mithilfe des SDK |\n| `integrationVersion` | `\"0.54.0\"` | Version der Erweiterung, des Plug-Ins oder des Unterteils der Anwendung |\n\nLegen Sie für eine eigenständige Anwendung ohne eine eindeutige Integration nur die Anwendungsfelder fest. Ein Entwicklerportal könnte beispielsweise `\"acme-developer-portal\"` auf `applicationVersion` und `\"2.4.0\"` auf `applicationName` setzen, wobei beide Integrationsfelder nicht festgelegt bleiben.\n\nDas SDK sendet Clientinformationen einmal, wenn sie die Verbindung herstellt. Die Identität gilt für die Lebensdauer dieser Verbindung.\n\n## Konfigurieren von Clientinformationen\n\nÜbergeben Sie Clientinformationen, wenn Sie den Client erstellen:\n\n
\n
TypeScript
\n\n```typescript\nimport { CopilotClient } from \"@github/copilot-sdk\";\n\nconst client = new CopilotClient({\n clientInfo: {\n applicationName: \"vscode\",\n applicationVersion: \"1.124.2\",\n integrationName: \"copilot-chat\",\n integrationVersion: \"0.54.0\",\n },\n});\n\nawait client.start();\n```\n\n
\n\n
Python
\n\n\n\n```python\nfrom copilot import CopilotClient\n\nclient = CopilotClient(\n client_info={\n \"application_name\": \"vscode\",\n \"application_version\": \"1.124.2\",\n \"integration_name\": \"copilot-chat\",\n \"integration_version\": \"0.54.0\",\n },\n)\nawait client.start()\n```\n\n
\n\n
Go
\n\n```golang\nclient := copilot.NewClient(&copilot.ClientOptions{\n ClientInfo: &copilot.ClientInfo{\n ApplicationName: \"vscode\",\n ApplicationVersion: \"1.124.2\",\n IntegrationName: \"copilot-chat\",\n IntegrationVersion: \"0.54.0\",\n },\n})\nif err := client.Start(ctx); err != nil {\n return err\n}\n```\n\n
\n\n
.NET
\n\n```csharp\nusing GitHub.Copilot;\n\nawait using var client = new CopilotClient(new CopilotClientOptions\n{\n ClientInfo = new CopilotClientInfo\n {\n ApplicationName = \"vscode\",\n ApplicationVersion = \"1.124.2\",\n IntegrationName = \"copilot-chat\",\n IntegrationVersion = \"0.54.0\",\n },\n});\n\nawait client.StartAsync();\n```\n\n
\n\n
Java
\n\n```java\nvar options = new CopilotClientOptions()\n .setClientInfo(new ClientInfo()\n .setApplicationName(\"vscode\")\n .setApplicationVersion(\"1.124.2\")\n .setIntegrationName(\"copilot-chat\")\n .setIntegrationVersion(\"0.54.0\"));\n\nvar client = new CopilotClient(options);\nclient.start().get();\n```\n\n
\n\n
Rust
\n\n```rust\nuse github_copilot_sdk::{Client, ClientInfo, ClientOptions};\n\nlet client = Client::start(\n ClientOptions::new().with_client_info(\n ClientInfo::new()\n .with_application_name(\"vscode\")\n .with_application_version(\"1.124.2\")\n .with_integration_name(\"copilot-chat\")\n .with_integration_version(\"0.54.0\"),\n ),\n)\n.await?;\n```\n\n
\n\n
\n\n## Hinweise\n\n* Client-Informationen dienen nur zur Orientierung. Die Laufzeit kann Werte ignorieren, die nicht mit dem erwarteten Format übereinstimmen, z. B. eine ungültige Versionszeichenfolge.\n* Das Festlegen von Client-Informationen ändert, wie die Laufzeit ihre Telemetriedaten zuordnet. Es ändert nicht, was die Laufzeitumgebung aufzeichnet.\n* Wenn alle Felder nicht gesetzt oder leer sind, übermittelt das SDK beim Handshake keine Client-Informationen, und die Laufzeit behält ihre standardmäßige Attribution bei."}