# S&P Brand Kit — agent pentru Microsoft 365 Copilot

Un agent care știe regulile de brand Stadler & Partners și îți spune ce fișier să iei, de unde, și ce e interzis.

Două drumuri. Primul e gata în zece minute.

---

## Drumul 1 — Agent Builder, fără cod

În aplicația Microsoft 365 Copilot: **Create** (sau *Agents → Create an agent*).

1. **Name:** `S&P Brand Kit`
2. **Description:** copiază câmpul `description` din `declarativeAgent.json`
3. **Instructions:** copiază integral câmpul `instructions` din `declarativeAgent.json`
4. **Knowledge:** adaugă biblioteca SharePoint unde ții pachetul de brand, sau lasă gol
5. **Starter prompts:** cele patru din `conversation_starters`
6. Publică și partajează

**Dezactivează generarea de imagini** dacă opțiunea există. Altfel agentul va încerca să deseneze logo-ul în loc să trimită la fișierul oficial.

---

## Drumul 2 — declarativeAgent.json, cu Agents Toolkit

Pentru când vrei agentul în control sursă și livrat ca aplicație.

`declarativeAgent.json` e scris pe **schema 1.8** și validat pe limitele ei:

| Câmp | Folosit | Limita schemei |
|---|---|---|
| `name` | 13 | 100 |
| `description` | 149 | 1.000 |
| `instructions` | 4.375 | 8.000 |
| `conversation_starters` | 4 | 12 |
| `WebSearch.sites` | 3 | 4 |

Site-urile respectă și regula de maximum 2 segmente de cale, fără parametri de interogare.

**Pași:**

1. VS Code → extensia **Microsoft 365 Agents Toolkit** → *Create a New Agent/App → Declarative Agent*
2. Înlocuiește `appPackage/declarativeAgent.json` generat cu fișierul acesta
3. Păstrează `manifest.json` generat de toolkit — versiunea lui de schemă trebuie să se potrivească cu unealta, deci lasă unealta să-l scrie
4. Icoane: folosește `logo/favicon/sp-mark-192.png` pentru color icon. Pentru outline icon îți trebuie o variantă alb pe transparent, 32×32
5. *Provision* și *Publish to organization*

---

## Ce conține configurarea și de ce

**`WebSearch` limitat la trei domenii** — `branding.stadlerpartners.com`, `stadlerpartners.ro`, `stadlerpartners.com` — nu căutare liberă pe internet. Un agent de brand care caută peste tot găsește și materiale vechi, și firme cu nume asemănător.

**Fără `GraphicArt`.** E capabilitatea de generare de imagini. Un agent care poate desena va desena logo-ul, prost, în loc să trimită la fișierul vectorial.

**Fără `OneDriveAndSharePoint`.** Se adaugă dacă ții pachetul într-o bibliotecă SharePoint:

```json
{ "name": "OneDriveAndSharePoint",
  "items_by_url": [ { "url": "https://<tenant>.sharepoint.com/sites/<site>/<bibliotecă>" } ] }
```

**Instrucțiunile sunt scrise în română**, dar conțin regula ca agentul să răspundă în limba în care i se scrie.

---

Documentația Microsoft: [schema 1.8 pentru agenți declarativi](https://learn.microsoft.com/en-us/microsoft-365/copilot/extensibility/declarative-agent-manifest-1.8) · [prezentare generală](https://learn.microsoft.com/en-us/microsoft-365/copilot/extensibility/overview-declarative-agent) · [cum se scriu instrucțiunile](https://learn.microsoft.com/en-us/microsoft-365/copilot/extensibility/declarative-agent-instructions)

Întrebări: office@stadlerpartners.com