Przejdź do treści
Biblioteka skilli
AI i agenci · Integracja z narzędziem

fabric-data-agent

/fabric-data-agent

Wywołuje opublikowanego agenta danych Fabric z aplikacji Universal App przez funkcję Rayfin, z uwierzytelnieniem aplikacji i MCP po streamable HTTP.

Repozytorium
rayfin ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Wywołuje opublikowanego agenta danych Fabric z aplikacji Universal App przez funkcję Rayfin, z uwierzytelnieniem aplikacji i MCP po streamable HTTP.

Oryginalny opis (EN)

Call a published Fabric data agent from a Universal App through a Rayfin function using application auth and MCP streamable HTTP. Use when the request names a Fabric data agent, data-agent MCP endpoint, or asks to chat with governed Fabric data through an app.

Jak działa

  1. Required input
  2. Fabric access token
  3. MCP exchange
  4. Long-running behavior
Sekcje z nagłówków SKILL.md, w oryginale · 104 linii, 471 słów
Podgląd SKILL.md
---
name: fabric-data-agent
description: >
  Call a published Fabric data agent from a Universal App through a Rayfin
  function using application auth and MCP streamable HTTP.
  Use when the request names a Fabric data agent, data-agent MCP endpoint, or
  asks to chat with governed Fabric data through an app.
---

# Fabric data agent

Use a Rayfin function so the Fabric access token remains server-side.
Read `functions-capability` and apply its pack before implementing this
workflow.

## Required input

Obtain the published data-agent MCP endpoint.
Do not substitute the legacy OpenAI-style endpoint.
The published endpoint has this shape:

```text
https://api.fabric.microsoft.com/v1/mcp/workspaces/{workspaceId}/dataagents/{dataAgentId}/agent
```

Use `ctx.Tokens.Fabric`, not an API key or service-principal secret.

## Fabric access token

Import the Fabric audience and context from the functions runtime:

```ts
import {
  AudienceType,
  UserDataFunctions,
  type RayfinContext,
} from '@microsoft/fabric-user-data-functions';

const udf = new UserDataFunctions();

udf.func(
  'askFabricDataAgent',
  async (
    ctx: RayfinContext<AppSchema, AudienceType.Fabric>,
    question: string
  ): Promise<DataAgentResult> => {
    const token: string = ctx.Tokens.Fabric;
    // Perform the MCP exchange and return only the bounded result.
  },
  [] // the audience in the annotation is the declaration
);
```

The audience union on the context annotation is what registers the connection —
declare it there, written literally as `AudienceType.Fabric`, and read the token
as `ctx.Tokens.Fabric`.
Requesting an audience the annotation does not declare is a compile error.
`ctx.getToken(...)` is deprecated and flagged by
`@typescript-eslint/no-deprecated`.

Send the token only in the server-side `Authorization: Bearer <token>` header.
Never return it to the browser or write it to application logs.
The deployed function accesses the data agent using the app identity's permissions.

## MCP exchange

The function performs this sequence:

1. Send `initialize`.
2. Send `notifications/initialized`.
3. Call `tools/list`.
4. Discover the advertised tool and its question argument.
5. Call `tools/call`.

Treat `Mcp-Session-Id` as optional.
Forward it when supplied, but do not fail initialization when it is absent.

Parse successful bodies according to their content type.
Support JSON and server-sent events for JSON-RPC responses.
Accept a non-JSON acknowledgement such as plain-text `Accepted` without trying
to parse it as JSON.

Use
[`references/mcp-streamable-http.md`](references/mcp-streamable-http.md)
as the reusable transport reference.
Copy and adapt the helper into the functions source only for a data-agent
scenario.
The general functions pack deliberately does not seed MCP code into every app.

Bound the question and the answer returned to the browser.
Do not log questions, answers, bearer tokens, provider bodies, or sensitive
exceptions.

## Long-running behavior

The function's outbound MCP deadline and the browser's wait for the function
invocation are independent.
Both must accommodate the operation.

Show a visible progress state explaining that a data-agent response may take up
to 10 minutes.
The current frontend SDK has a client-wide timeout rather than a
per-invocation timeout.
Do not make an extended timeout the default for every app operation.
If needed, isolate the workaround to a dedicated data-agent client and document
that the full platform execution duration remains to be verified.

Do not return from the UDF and expect work to continue in the background.
The current MCP `tools/call` is one awaited request.
A start-and-poll design requires a durable operation ID from the downstream
service or an app-owned queue, worker, and result store.
Pliki w paczce (2)
  • SKILL.md 4 KB
  • references/mcp-streamable-http.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie fabric-data-agent.

Migawka bazy z 13.11.2026 · wersja paczki 7b30c171fee7 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100connectors
    Łączy Universal App z istniejącymi źródłami danych Fabric: Warehouse, bazą SQL, punktem SQL analytics Lakehouse lub modelem semantycznym Power BI, przez katalog konektorów Rayfin.
  • 100rayfin-connectors
    Podłącza istniejące źródła danych Fabric (Lakehouse, Warehouse, SQL Database, model semantyczny, KQL Database) do aplikacji Rayfin: odkrywanie, konfiguracja, encje, autoryzacja i diagnostyka.
  • 95Fabric
    Zarządza wzorcami promptów Fabric: uruchamia je na treści, synchronizuje z repozytorium i tworzy podsumowania.
  • 95Fabric
    Wyciąga wnioski z treści za pomocą ponad 240 wzorców promptów Fabric, dopasowanych do analizy i przekształcania tekstu.
  • 100fabric-app-workflow
    Pomaga dodawać wykresy i zapytania do aplikacji danych Fabric Rayfin nad modelem semantycznym według ustalonych konwencji.
  • 90fabric
    Wybiera jeden z trybów pracy wielu agentów dla zadania, uzasadnia wybór w jednym zdaniu i uruchamia właściwy tryb.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.